InstallStatusMIFEx-Funktion

Die InstallStatusMIFEx Funktion in Configuration Manager verbessert die Funktionalität von InstallStatusMIF.

Syntax

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

Parameter

pszFileName Zeiger auf einen eindeutigen Namen für die MIF-Datei (Management Information Format). 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 wird. Dieser Parameter ist auf 128 Zeichen beschränkt.

bStatus true, wenn die Installation status erfolgreich ist.

bProgramReboots true , wenn das Programm den Computer neu startet.

Rückgabewerte

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

Hinweise

InstallStatusMIFEx ist funktional äquivalent zu InstallStatusMIF, mit Ausnahme der Hinzufügung des bProgramReboot-Parameters. Die Verwendung von bProgramRebootist die zuverlässigste Möglichkeit, diese Informationen an Configuration Manager zu übergeben, da Configuration Manager während des Neustarts möglicherweise nicht in der Lage sind, den richtigen Exitcode aus dem Prozess abzurufen. Wenn das Programm nach Abschluss der Programmausführung dieses Flag in der MIF-Datei festlegt und kein Neustart erfolgt ist, wartet Configuration Manager eine Minute, bevor ein anderes Programm gestartet wird. Dies bietet genügend Zeit, um den Neustart abzuschließen. Dieses Flag ermöglicht es Configuration Manager auch, eine vorläufige Erfolgsmeldung status für das Programm und dann eine endgültige Erfolgsmeldung status nach dem Neustart zu senden.

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

Die Parameter pszFilename, pszCompany, pszProductund pszVersion stehen in direktem Zusammenhang mit den Eigenschaften der SMS_Package Server-WMI-KlasseMIFFileName, MIFPublisher, MIFNamebzwMIFVersion. Diese Parameter und Eigenschaften müssen die gleichen Werte enthalten.

Anforderungen

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

Version: Erfordert SMS 2003 Advanced Client.

Bibliothek: Als Ressource in IsMIF32.dll (C/C++) enthalten.

Siehe auch

Status MIF FunctionsInstallStatusMIFSMS_Package Server WMI-Klasse