Fonction InstallStatusMIFEx

La InstallStatusMIFEx fonction, dans Configuration Manager, améliore la fonctionnalité d’InstallStatusMIF.

Syntaxe

DWORD InstallStatusMIFEx(
     char* pszFileName,
     char* pszCompany,
     char* pszProduct,
     char* pszVersion,
     char* pszLocale,
     char* pszSerialNo,
     char* pszMessage,
     BOOL bStatus,
     BOOL bProgramReboots
);

Paramètres

pszFileName Pointeur vers un nom unique pour le fichier MIF (Management Information Format). L’extension de nom de fichier doit être .mif. La fonction écrit le fichier dans le répertoire %TEMP %.

pszCompany Pointeur vers le fabricant ou l’éditeur du produit, par exemple, Microsoft. Ce paramètre est limité à 64 caractères.

pszProduct Pointeur sur le nom du produit ou du programme, par exemple, Microsoft Office 2000. Ce paramètre est limité à 64 caractères.

pszVersion Pointeur vers la version du produit, par exemple, 8.0a. Ce paramètre est limité à 64 caractères.

pszLocale Pointeur sur le code de pays/région ou de langue, par exemple ENU. Ce paramètre est facultatif et limité à 16 caractères.

pszSerialNo Pointeur sur le numéro de série du produit. Ce paramètre est facultatif et limité à 64 caractères.

pszMessagePointeur vers un message descriptif sur le status de l’installation, qui est ajouté au message de status du programme. Ce paramètre est limité à 128 caractères.

bStatus truesi le status de l’installation est réussi.

bProgramReboots true si le programme redémarre l’ordinateur.

Valeurs de retour

Valeur non nulle pour indiquer la réussite.

Remarques

InstallStatusMIFEx est fonctionnellement équivalent à InstallStatusMIF, à l’exception de l’ajout bProgramRebootdu paramètre. L’utilisation bProgramRebootest la méthode la plus fiable pour transmettre ces informations à Configuration Manager, car il se peut que, pendant le redémarrage, le Configuration Manager ne puisse pas obtenir le code de sortie correct du processus. Si, après avoir exécuté le programme, le programme définit cet indicateur dans le fichier MIF et qu’aucun redémarrage n’a eu lieu, le Gestionnaire de Configuration Manager attend une minute avant de lancer un autre programme. Cela laisse suffisamment de temps pour que le redémarrage se termine. Cet indicateur permet également à Configuration Manager d’envoyer un message préliminaire de status de réussite pour le programme, puis un message de status de réussite final après le redémarrage.

Votre application d’installation (configuration) ne doit créer qu’un seul fichier MIF de status d’installation pour le package. Le nom de fichier que vous spécifiez doit être unique.

Les installations qui s’exécutent sur des versions localisées de Configuration Manager doivent spécifier les valeurs dans le format approprié : format ANSI pour les langues européennes ; Format DBCS pour les langues d’Asie de l’Est.

Votre application doit appeler InstallStatusMIFEx avant la fermeture de l’installation. Le fichier MIF n’est pas signalé à Configuration Manager si l’installation crée un autre processus qui appelle InstallStatusMIFEx.

Les paramètres pszFilename, pszCompany, pszProductet pszVersion sont directement liés aux propriétés MIFFileNamede classe WMI du serveur SMS_Package , MIFPublisher, MIFNameet MIFVersion, respectivement. Ces paramètres et propriétés doivent contenir les mêmes valeurs.

Configuration requise

Windows NT/2000 : nécessite Windows 2000 ou une version ultérieure.

Version : nécessite SMS 2003 Advanced Client.

Bibliothèque : incluse en tant que ressource dans IsMIF32.dll (C/C++).

Voir aussi

État Fonctions MIFInstallStatusMIFSMS_Package Server Classe WMI