InstallStatusMIF-Funktion

Die InstallStatusMIF Funktion erstellt eine MIF-Datei (status Management Information Format), die Configuration Manager verwendet, um die Installations-status 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. Eine Dateinamenerweiterung muss .mif sein. Die Funktion schreibt die Datei in das Verzeichnis %TEMP%.

pszCompany Zeiger auf den Hersteller oder Herausgeber des Produkts, z. B. Microsoft. Dieser Parameter ist auf 64 Zeichen beschränkt.

pszProduct Zeiger auf den Produkt- oder Programmnamen, z. B. Microsoft Office 2000. Dieser Parameter ist auf 64 Zeichen beschränkt.

pszVersion Zeiger auf die Version des Produkts, z. B. 8.0a. Dieser Parameter ist auf 64 Zeichen beschränkt.

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 die status der Installation, die dem Programm status Nachricht hinzugefügt wurde. Dieser Parameter ist auf 128 Zeichen beschränkt.

bStatus true, wenn die Installation status erfolgreich ist.

Rückgabewerte

Ein Wert ungleich 0 (null), der den Erfolg anzeigt.

Hinweise

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

Installationen, die auf 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 aufrufen, InstallStatusMIF bevor die Installation beendet wird. Die MIF-Datei wird nicht an Configuration Manager gemeldet, wenn die Installation einen anderen Prozess erstellt, der aufruftInstallStatusMIF.

Beachten Sie, dass die Parameter pszFilename, pszCompany, pszProductund pszVersion direkt mit den SMS_Package Server-WMI-KlasseneigenschaftenMIFFileName, MIFPublisher, MIFNamebzw MIFVersion. verknüpft sind. Diese Parameter und Eigenschaften müssen die gleichen 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 Configuration Manager Clientinstallation auf dem Clientcomputer installiert.

Das Beispiel im nächsten Abschnitt zeigt, wie die Funktion mithilfe der InstallStatusMIF Ismif32.dll-Datei direkt 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 (C/C++) enthalten; Ismif16.dll (C/C++).

Siehe auch

WMI-Klasse "Status MIF Functions SMS_Package Server"