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.
pszMessage
Zeiger 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 Ostasiensprachen.
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++).