InstallStatusMIFEx, fonction

La InstallStatusMIFEx fonction, dans Configuration Manager, améliore les fonctionnalités 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). Une 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 vers 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 vers le code du pays/de la région ou de la langue, par exemple, ENU. Ce paramètre est facultatif et limité à 16 caractères.

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

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

bStatus truesi le status d’installation réussit.

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

Valeurs de retour

Valeur différente de zéro pour indiquer la réussite.

Remarques

InstallStatusMIFEx est fonctionnellement équivalent à , à InstallStatusMIFl’exception de l’ajout du bProgramRebootparamètre . L’utilisation bProgramRebootde est le moyen le plus fiable de transmettre ces informations à Configuration Manager, car pendant le redémarrage Configuration Manager peut ne pas être en mesure d’obtenir le code de sortie correct à partir du processus. Si, après avoir terminé l’exécution du programme, le programme définit cet indicateur dans le fichier MIF et qu’un redémarrage n’a pas eu lieu, Configuration Manager attend une minute avant de lancer tout autre programme. Cela laisse suffisamment de temps pour que le redémarrage se termine. Cet indicateur permet également à Configuration Manager d’envoyer un message de status de réussite préliminaire pour le programme, puis un message status de réussite final après le redémarrage.

Votre application d’installation (programme d’installation) doit créer une seule installation status fichier MIF 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 des valeurs au format approprié : format ANSI pour les langues européennes ; DBCS format pour les langues de l’Asie de l’Est.

Votre application doit appeler InstallStatusMIFEx avant la fin 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 SMS_Package Server , 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 version ultérieure.

Version : nécessite SMS 2003 Advanced Client.

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

Voir aussi

Status MIF FunctionsInstallStatusMIFSMS_Package Server WMI Class