InstallStatusMIFEx, fonction

Article
04/04/2023

La InstallStatusMIFEx fonction, dans Configuration Manager, améliore les fonctionnalités de 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.

pszMessage
Pointeur vers un message descriptif sur l’état de l’installation, qui est ajouté au message d’état du programme. Ce paramètre est limité à 128 caractères.

bStatus
true si l’état d’installation est réussi.

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 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 d’état de réussite préliminaire pour le programme, puis un message d’état de réussite final après le redémarrage.

Votre application d’installation (programme d’installation) doit créer un seul fichier MIF d’état 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 des valeurs au 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 fin de l’installation. Le fichier MIF n’est pas signalé à Configuration Manager si l’installation crée un autre processus qui appelle InstallStatusMIFEx.

Notez que les paramètres pszFilename, pszCompany, pszProductet pszVersion sont directement liés aux propriétés MIFFileNamede la 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

Fonctions MIF d’état
InstallStatusMIF
Classe WMI du serveur SMS_Package

Partager via