InstallStatusMIF, fonction
La InstallStatusMIF fonction crée un fichier MIF (Management Information Format) d’état que Configuration Manager utilise pour mettre en corrélation l’état d’installation d’une publication.
Syntaxe
DWORD InstallStatusMIF(
char* pszFileName,
char* pszCompany,
char* pszProduct,
char* pszVersion,
char* pszLocale,
char* pszSerialNo,
char* pszMessage,
BOOL bStatus
);
Paramètres
pszFileName
Pointeur vers un nom unique pour le fichier MIF. 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 est limité à 16 caractères.
pszSerialNo
Pointeur vers le numéro de série du produit. Ce paramètre est facultatif et est limité à 64 caractères.
pszMessage
Pointeur vers un message descriptif sur l’état de l’installation, 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.
Valeurs de retour
Valeur différente de zéro pour indiquer la réussite.
Remarques
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 InstallStatusMIF 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 InstallStatusMIF.
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.
La InstallStatusMIF fonction est fournie dans une version 32 bits (Ismif32.dll) et une version 16 bits (Ismif16.dll). La DLL appropriée est installée sur l’ordinateur client pendant le processus d’installation du client Configuration Manager.
L’exemple de la section suivante montre comment appeler la InstallStatusMIF fonction directement à l’aide du fichier Ismif32.dll. Un échec de chargement du fichier Ismif32.dll peut indiquer que le système n’est pas un client Configuration Manager.
Exemple
[C/C++]
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);
#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)
HINSTANCE hinst;
int RetCode;
hinst = LoadLibrary("ismif32.dll");
InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");
if (InstallStatusMIF)
{
RetCode = InstallStatusMIF("Status",
"Microsoft",
"Microsoft SQL Server 7.0",
"7.00.000",
"ENU",
NULL,
"Installation Successful",
true);
}
FreeLibrary(hinst);
Configuration requise
Windows NT/2000 : nécessite Windows NT 4.0 ou version ultérieure.
Windows 95/98 : nécessite Windows 95 ou version ultérieure.
Version : nécessite SMS 2.0.
Bibliothèque : incluse en tant que ressource dans Ismif32.dll (C/C++) ; Ismif16.dll (C/C++).