InstallStatusMIF – funkce

Článek
04/04/2023

Funkce InstallStatusMIF vytvoří soubor MIF (Status Management Information Format), který Configuration Manager používá ke korelaci stavu instalace pro reklamu.

Syntaxe

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

Parametry

pszFileName
Ukazatel na jedinečný název souboru MIF. 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 přidanou do stavové zprávy programu. Tento parametr je omezen na 128 znaků.

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

Návratové hodnoty

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

Poznámky

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 ve východní Asii.

Aplikace musí volat InstallStatusMIF před ukončením instalace. Soubor MIF není hlášen jako Configuration Manager, pokud instalace vytvoří jiný proces, který volá InstallStatusMIF.

Všimněte si, že parametry pszFilename, pszCompany, pszProducta pszVersion jsou přímo spojené s vlastnostmi MIFFileNametřídy služby WMI serveru SMS_Package , MIFPublisher, MIFNamea MIFVersionv uvedeném pořadí. Tyto parametry a vlastnosti musí obsahovat stejné hodnoty.

Funkce InstallStatusMIF je k dispozici ve 32bitové verzi (Ismif32.dll) a 16bitové verzi (Ismif16.dll). Příslušná knihovna DLL je nainstalována v klientském počítači během procesu instalace klienta Configuration Manager.

Příklad v další části ukazuje, jak funkci volat InstallStatusMIF přímo pomocí souboru Ismif32.dll. Selhání načtení souboru Ismif32.dll může znamenat, že systém není Configuration Manager klientem.

Příklad

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

Požadavky

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

Windows 95/98: Vyžaduje Windows 95 nebo novější.

Verze: Vyžaduje SMS 2.0.

Knihovna: Zahrnuto jako prostředek v Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Viz taky

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

Sdílet prostřednictvím