InstallStatusMIF, fonction

La InstallStatusMIF fonction crée un fichier MIF (Management Information Format) status que Configuration Manager utilise pour mettre en corrélation les status 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.

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

bStatus truesi le status d’installation réussit.

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 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 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++).

Voir aussi

Status MIF FunctionsSMS_Package Server WMI Class