InstallStatusMIFEx Funktion

Die InstallStatusMIFEx Funktion im Configuration Manager erweitert 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). 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 zur Programm-status-Meldung hinzugefügt wird. Dieser Parameter darf maximal 128 Zeichen lang sein.

bStatus trueWenn der Status der Installation erfolgreich ist.

bProgramReboots true , wenn das Programm den Computer neu startet.

Rückgabewerte

Ein Wert ungleich null, um den Erfolg anzuzeigen.

Hinweise

InstallStatusMIFEx ist funktional äquivalent zu InstallStatusMIF, mit Ausnahme der Hinzufügung des bProgramRebootParameters. Die Verwendung bProgramRebootist die zuverlässigste Methode, um diese Informationen an Configuration Manager zu übergeben, da der Configuration Manager während des Neustarts möglicherweise nicht den richtigen Exitcode aus dem Prozess abrufen kann. Wenn das Programm nach Abschluss der Programmausführung dieses Kennzeichen in der MIF-Datei festlegt und kein Neustart erfolgt ist, wartet Configuration Manager eine Minute lang, bevor ein anderes Programm gestartet wird. So bleibt genügend Zeit für den Neustart. Mit diesem Flag kann der Configuration Manager außerdem eine vorläufige Meldung über den Status des Erfolgs für das Programm und nach erfolgtem Neustart eine endgültige Meldung über den Status senden.

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

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

Anforderungen

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

Version: Erfordert SMS 2003 Advanced Client.

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

Siehe auch

Status MIF-FunktionenInstallStatusMIFSMS_Package Server WMI-Klasse