InstallStatusMIF Function

Die InstallStatusMIF Funktion erstellt eine MIF-Datei (Status Management Information Format), die von Configuration Manager verwendet wird, um den Installationsstatus für eine Ankündigung zu korrelieren.

Syntax

DWORD InstallStatusMIF(
     char* pszFileName,
     char* pszCompany,
     char* pszProduct,
     char* pszVersion,
     char* pszLocale,
     char* pszSerialNo,
     char* pszMessage,
     BOOL bStatus
);

Parameter

pszFileName Zeiger auf einen eindeutigen Namen für die MIF-Datei. Die Dateinamenerweiterung muss .mif sein. Die Funktion schreibt die Datei in das Verzeichnis %TEMP%.

pszCompany Verweist auf den Hersteller oder Herausgeber des Produkts, z. B. Microsoft. Dieser Parameter darf maximal 64 Zeichen lang sein.

pszProduct Zeiger auf den Produkt- oder Programmnamen, z. B. Microsoft Office 2000. Dieser Parameter darf maximal 64 Zeichen lang sein.

pszVersion Zeiger auf die Version des Produkts, z. B. 8.0a. Dieser Parameter darf maximal 64 Zeichen lang sein.

pszLocale Zeiger auf das Land/die Region oder den Sprachcode, z. B. ENU. Dieser Parameter ist optional und auf 16 Zeichen beschränkt.

pszSerialNo Zeiger auf die Seriennummer des Produkts. Dieser Parameter ist optional und auf 64 Zeichen beschränkt.

pszMessageZeiger auf eine beschreibende Meldung über den Status der Installation, die der Programm-Statusmeldung hinzugefügt wurde. Dieser Parameter darf maximal 128 Zeichen lang sein.

bStatus trueWenn der Status der Installation erfolgreich ist.

Rückgabewerte

Ein Wert ungleich null, um den Erfolg anzuzeigen.

Hinweise

Ihre Installationsanwendung (Setupanwendung) darf nur eine Installations- status MIF-Datei für das Paket erstellen. Der angegebene Dateiname muss eindeutig sein.

Installationen, die unter lokalisierten Versionen von Configuration Manager ausgeführt werden, müssen Werte im entsprechenden Format angeben: ANSI-Format für europäische Sprachen; DBCS-Format für ostasiatische Sprachen.

Ihre Anwendung muss aufgerufen werden InstallStatusMIF , bevor die Installation beendet wird. Die MIF-Datei wird nicht an den Configuration Manager gemeldet, wenn die Installation einen anderen Prozess erstellt, der aufruft.InstallStatusMIF

Beachten Sie, dass die Parameter pszFilename, pszCompany, pszProductund pszVersion in direktem Zusammenhang mit den Eigenschaften MIFFileNameder SMS_Package Server WMI-Klasse , MIFPublisherMIFName, bzwMIFVersion. stehen. Diese Parameter und Eigenschaften müssen dieselben Werte enthalten.

Die InstallStatusMIF Funktion wird in einer 32-Bit-Version (Ismif32.dll) und einer 16-Bit-Version (Ismif16.dll) bereitgestellt. Die entsprechende DLL wird während der Installation des Configuration Manager-Clients auf dem Clientcomputer installiert.

Das Beispiel im nächsten Abschnitt zeigt, wie die InstallStatusMIF Funktion direkt mithilfe der Ismif32.dll Datei aufgerufen wird. Ein Fehler beim Laden der Ismif32.dll Datei kann darauf hindeuten, dass das System kein Configuration Manager Client ist.

Beispiel

[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);

Anforderungen

Windows NT/2000: Erfordert Windows NT 4.0 oder höher.

Windows 95/98: Erfordert Windows 95 oder höher.

Version: Erfordert SMS 2.0.

Bibliothek: Als Ressource in Ismif32.dll enthalten (C/C++); Ismif16.dll (C/C++).

Siehe auch

Status MIF-FunktionenSMS_Package Server WMI-Klasse