InstallStatusMIFEx-Funktion

Artikel
04/04/2023

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.

pszMessage
Zeiger auf eine beschreibende Meldung zum Status der Installation, die der Statusmeldung des Programms hinzugefügt wird. Dieser Parameter ist auf 128 Zeichen beschränkt.

bStatus
true , wenn der Installationsstatus erfolgreich lautet.

bProgramReboots
true , wenn das Programm den Computer neu startet.

Rückgabewerte

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

HinwBemerkungeneise

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 stattgefunden hat, 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 Erfolgsstatusmeldung für das Programm und dann eine endgültige Erfolgsstatusmeldung nach dem Neustart zu senden.

Ihre Installationsanwendung (Setup) muss nur eine MIF-Datei mit dem Installationsstatus 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 Ostasiensprachen.

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.

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.

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

MIF-Statusfunktionen
InstallStatusMIF
WMI-Klasse des SMS_Package-Servers

Teilen über