Funkcja InstallStatusMIFEx

Funkcja InstallStatusMIFEx w programie Configuration Manager zwiększa funkcjonalność InstallStatusMIF.

Składnia

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

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 ograniczony do 64 znaków.

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

bStatus true Jeśli stan instalacji to powodzenie.

bProgramReboots true czy program uruchomi ponownie komputer.

Wartości zwracane

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

Uwagi

InstallStatusMIFEx jest funkcjonalnie równoważny , InstallStatusMIFz wyjątkiem dodania parametru bProgramReboot. Użycie bProgramRebootjest najbardziej niezawodnym sposobem przekazania tych informacji do programu Configuration Manager, ponieważ podczas ponownego uruchamiania program Configuration Manager może nie być w stanie uzyskać poprawnego kodu wyjścia z procesu. Jeśli po zakończeniu wykonywania programu program ustawi tę flagę w pliku MIF i nie nastąpi ponowne uruchomienie, program Configuration Manager czeka minutę przed uruchomieniem innego programu. Dzięki temu masz wystarczająco dużo czasu na dokończenie ponownego rozruchu. Ta flaga umożliwia również programowi Configuration Manager wysyłanie wstępnego komunikatu o stanie powodzenia programu, a następnie ostatecznego komunikatu o stanie sukcesu po ponownym uruchomieniu.

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

ParametrypszFilename, pszCompany, , pszProducti pszVersion są bezpośrednio związane odpowiednio z właściwościami MIFNameMIFFileNameMIFPublisherMIFVersionklasy WMI serwera SMS_Package, oraz . 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 SMS 2003 Advanced.

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

Zobacz też

Funkcje MIF stanuInstallStatusMIFSMS_Package Klasa WMI serwera