Funkcja InstallStatusMIF

Ta InstallStatusMIF funkcja tworzy plik MIF (Status Management Information Format), którego program Configuration Manager używa do korelowania stanu instalacji dla ogłoszenia.

Składnia

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

Parametry

pszFileName Wskaźnik unikatowej nazwy pliku MIF. Rozszerzenie nazwy pliku musi być .mif. Funkcja zapisuje plik w katalogu %TEMP%.

pszCompany Wskaźnik do producenta lub wydawcy produktu, na przykład Microsoft. Długość tego parametru jest ograniczona do 64 znaków.

pszProduct Wskaźnik do nazwy produktu lub programu, na przykład Microsoft Office 2000. Długość tego parametru jest ograniczona do 64 znaków.

pszVersion Wskaźnik wersji produktu, na przykład 8.0a. Długość tego parametru jest ograniczona do 64 znaków.

pszLocale Wskaźnik do kodu kraju/regionu lub języka, na przykład ENU. Ten parametr jest opcjonalny i ograniczony do 16 znaków.

pszSerialNo Wskaźnik do numeru seryjnego produktu. Ten parametr jest opcjonalny i może mieć maksymalnie 64 znaki.

pszMessage Wskaźnik do komunikatu opisowego dotyczącego stanu instalacji, dodawanego do komunikatu o stanie programu. Ten parametr jest ograniczony do 128 znaków.

bStatus true Jeśli stan instalacji to powodzenie.

Wartości zwracane

Wartość różna od zera oznaczająca sukces.

Uwagi

Aplikacja instalacyjna (instalacyjna) musi utworzyć tylko jeden plik MIF stanu instalacji dla pakietu. Podana nazwa pliku musi być unikatowa.

Instalacje uruchamiane na zlokalizowanych wersjach programu Configuration Manager muszą określać wartości w odpowiednim formacie: format ANSI dla języków europejskich; Format DBCS dla języków wschodnioazjatyckich.

Wniosek musi zostać wywołany InstallStatusMIF przed zakończeniem instalacji. Plik MIF nie jest zgłaszany do programu Configuration Manager, jeśli instalacja tworzy inny proces wywołujący InstallStatusMIFmetodę MIF

Należy pamiętać, że parametry pszFilename, pszCompany, , pszProducti pszVersion są bezpośrednio związane odpowiednio z właściwościami MIFFileNameklasy WMI serwera SMS_Package serwera, MIFVersionMIFPublisherMIFName, , oraz . Te parametry i właściwości muszą zawierać te same wartości.

Ta InstallStatusMIF funkcja jest dostępna w wersji 32-bitowej (Ismif32.dll) i 16-bitowej (Ismif16.dll). W trakcie procesu instalacji klienta programu Configuration Manager na kliencie jest instalowana odpowiednia biblioteka DLL.

W przykładzie w następnej sekcji pokazano, InstallStatusMIF jak wywołać funkcję przy użyciu pliku Ismif32.dll bezpośrednio. Niepowodzenie ładowania pliku Ismif32.dll może wskazywać, że system nie jest klientem Configuration Manager.

Przykład

[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);

Wymagania

Windows NT/2000: Wymaga systemu Windows NT 4.0 lub nowszego.

Windows 95/98: Wymaga systemu Windows 95 lub nowszego.

Wersja: Wymaga SMS-a 2.0.

Biblioteka: Dołączona jako zasób w Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Zobacz też

Stan funkcji MIFSMS_Package klasy WMI serwera