InstallStatusMIF, funkcja

Funkcja InstallStatusMIF tworzy plik MIF (Management Information Format), który Configuration Manager używany do skorelowania stanu instalacji anonsu.

Składnia

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

Parametry

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

pszCompany Wskaźnik do producenta lub wydawcy produktu, na przykład firmy Microsoft. Ten parametr jest ograniczony do 64 znaków.

pszProduct Wskaźnik do nazwy produktu lub programu, na przykład Microsoft Office 2000. Ten parametr jest ograniczony do 64 znaków.

pszVersion Wskaźnik do wersji produktu, na przykład 8.0a. Ten parametr jest ograniczony do 64 znaków.

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

pszSerialNo Wskaźnik do numeru seryjnego produktu. Ten parametr jest opcjonalny i jest ograniczony do 64 znaków.

pszMessage Wskaźnik do opisowego komunikatu o stanie instalacji, dodany do komunikatu o stanie programu. Ten parametr jest ograniczony do 128 znaków.

bStatus true jeśli stan instalacji jest pomyślny.

Wartości zwracane

Wartość niezerowa wskazująca powodzenie.

Uwagi

Aplikacja instalacka (instalacka) musi utworzyć tylko jeden plik MIF stanu instalacji dla pakietu. Określona nazwa pliku musi być unikatowa.

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

Aplikacja musi zostać wywołana InstallStatusMIF przed zakończeniem instalacji. Plik MIF nie jest zgłaszany do Configuration Manager, jeśli instalacja tworzy inny proces, który wywołuje .InstallStatusMIF

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

Funkcja InstallStatusMIF jest udostępniana w wersji 32-bitowej (Ismif32.dll) i wersji 16-bitowej (Ismif16.dll). Odpowiednia biblioteka DLL jest zainstalowana na komputerze klienckim podczas procesu instalacji klienta Configuration Manager.

W przykładzie w następnej sekcji pokazano, jak wywołać funkcję InstallStatusMIF bezpośrednio przy użyciu pliku Ismif32.dll. 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 programu SMS 2.0.

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

Zobacz też

Status MIF FunctionsSMS_Package Server WMI Class (Klasa WMI serwera mif stanu)