Fonction InstallStatusMIF

La InstallStatusMIF fonction crée un fichier MIF (Management Information Format) de status que le Configuration Manager utilise pour mettre en corrélation le 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 sur un nom unique pour le fichier MIF. 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 est limité à 64 caractères.

pszMessagePointeur vers un message descriptif sur le status de l’installation, 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.

Valeurs de retour

Valeur non nulle pour indiquer la réussite.

Remarques

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 InstallStatusMIF 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 InstallStatusMIF.

Notez que les paramètres pszFilename, , pszProductpszCompanyet sont pszVersion 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.

La InstallStatusMIF fonction est disponible en version 32 bits (Ismif32.dll) et 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 en utilisant directement le 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 une 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

État Fonctions MIFSMS_Package serveur Classe WMI