InstallStatusMIFEx – funkce

Článek
01/19/2024

Funkce InstallStatusMIFEx v Configuration Manager vylepšuje funkce InstallStatusMIF.

Syntaxe

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

Parametry

pszFileName
Ukazatel na jedinečný název souboru MIF (Management Information Format). Přípona názvu souboru musí být .mif. Funkce zapíše soubor do adresáře %TEMP%.

pszCompany
Ukazatel na výrobce nebo vydavatele produktu, například Microsoft. Tento parametr je omezen na 64 znaků.

pszProduct
Ukazatel na název produktu nebo aplikace, například Microsoft Office 2000. Tento parametr je omezen na 64 znaků.

pszVersion
Ukazatel na verzi produktu, například 8.0a. Tento parametr je omezen na 64 znaků.

pszLocale
Ukazatel na kód země/oblasti nebo jazyka, například ENU. Tento parametr je volitelný a je omezený na 16 znaků.

pszSerialNo
Ukazatel na sériové číslo produktu. Tento parametr je volitelný a je omezený na 64 znaků.

pszMessage
Ukazatel na popisnou zprávu o stavu instalace, která je přidána do stavové zprávy programu. Tento parametr je omezen na 128 znaků.

bStatus
true pokud je stav instalace úspěšný.

bProgramReboots
true pokud program restartuje počítač.

Návratové hodnoty

Nenulová hodnota označující úspěch.

Poznámky

InstallStatusMIFEx je funkčně ekvivalentní k InstallStatusMIF, s výjimkou přidání parametru bProgramReboot. Použití bProgramRebootje nejspolehlivější způsob předání těchto informací Configuration Manager, protože během restartování Configuration Manager nemusí být schopen získat správný ukončovací kód z procesu. Pokud program po dokončení provádění programu nastaví tento příznak v souboru MIF a nedošlo k restartování, Configuration Manager počká jednu minutu před spuštěním jakéhokoli jiného programu. To poskytuje dostatek času na dokončení restartování. Tento příznak také umožňuje Configuration Manager odeslat předběžnou zprávu o stavu úspěšného programu a po restartování odeslat konečnou zprávu o stavu úspěchu.

Vaše instalační (instalační) aplikace musí pro balíček vytvořit pouze jeden soubor MIF se stavem instalace. Zadaný název souboru musí být jedinečný.

Instalace, které běží v lokalizovaných verzích Configuration Manager, musí určovat hodnoty v příslušném formátu: formát ANSI pro evropské jazyky; Formát DBCS pro jazyky východní Asie.

Aplikace musí volat InstallStatusMIFEx před ukončením instalace. Soubor MIF se nehlásí Configuration Manager, pokud instalace vytvoří jiný proces, který volá InstallStatusMIFEx.

Parametry pszFilename, pszCompany, pszProducta pszVersion přímo souvisejí s vlastnostmi MIFFileNametřídy služby WMI serveru SMS_Package , MIFPublisher, MIFNamea MIFVersion. Tyto parametry a vlastnosti musí obsahovat stejné hodnoty.

Požadavky

systém Windows NT/2000: Vyžaduje Systém Windows 2000 nebo novější.

Verze: Vyžaduje rozšířeného klienta SMS 2003.

Knihovna: Zahrnuto jako prostředek v IsMIF32.dll (C/C++).

Viz taky

Stavové funkce MIF
InstallStatusMIF
Serverová třída služby WMI SMS_Package

Sdílet prostřednictvím