InstallStatusMIFEx, funkcja

Funkcja InstallStatusMIFEx w Configuration Manager rozszerza funkcjonalność funkcji InstallStatusMIF.

Składni

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

Parametry

pszFileName
Wskaźnik do unikatowej nazwy pliku MIF (Management Information Format). 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 może zawierać maksymalnie 16 znaków.

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

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

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

bProgramReboots
true jeśli program uruchomi ponownie komputer.

Wartości zwracane

Wartość niezerowa wskazująca powodzenie.

Uwagi

InstallStatusMIFEx jest funkcjonalnie równoważne InstallStatusMIF, z wyjątkiem dodawania parametru bProgramReboot. Użycie bProgramRebootjest najbardziej niezawodnym sposobem przekazywania tych informacji do Configuration Manager, ponieważ podczas ponownego uruchamiania Configuration Manager może nie być w stanie uzyskać poprawnego kodu zakończenia z procesu. Jeśli po zakończeniu wykonywania programu program ustawi tę flagę w pliku MIF, a ponowne uruchomienie nie zostało wykonane, Configuration Manager czeka przez minutę przed uruchomieniem innego programu. Pozwala to na zakończenie ponownego uruchamiania. Ta flaga umożliwia również Configuration Manager wysłanie wstępnego komunikatu o stanie powodzenia dla programu, a następnie końcowy komunikat o stanie powodzenia po ponownym uruchomieniu.

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 InstallStatusMIFEx przed zakończeniem instalacji. Plik MIF nie jest zgłaszany do Configuration Manager, jeśli instalacja tworzy inny proces, który wywołuje .InstallStatusMIFEx

Parametry pszFilename, pszCompany, pszProducti pszVersion są bezpośrednio powiązane z właściwościami MIFFileNameklasy WMI serwera SMS_Package , MIFPublisher, MIFName, i MIFVersion, odpowiednio. Te parametry i właściwości muszą zawierać te same wartości.

Wymagania

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

Wersja: Wymaga klienta zaawansowanego programu SMS 2003.

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

Zobacz też

Funkcje MIF stanu
InstallStatusMIF
SMS_Package Server WMI Class