Funktionen InstallStatusMIF

Funktionen InstallStatusMIF skapar en MIF-fil (status Management Information Format) som Configuration Manager använder för att korrelera installationsstatus för en annons.

Syntax

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

Parametrar

pszFileName Pekare till ett unikt namn för MIF-filen. Filnamnstillägget måste vara .mif. Funktionen skriver filen till katalogen %TEMP%.

pszCompany Pekare till produktens tillverkare eller utgivare, till exempel Microsoft. Den här parametern är begränsad till 64 tecken.

pszProduct Pekare till produkt- eller programnamnet, till exempel Microsoft Office 2000. Den här parametern är begränsad till 64 tecken.

pszVersion Peka på produktversionen, till exempel 8.0a. Den här parametern är begränsad till 64 tecken.

pszLocale Pekare till lands-/region- eller språkkoden, till exempel ENU. Den här parametern är valfri och är begränsad till 16 tecken.

pszSerialNo Pekare till produktens serienummer. Den här parametern är valfri och är begränsad till 64 tecken.

pszMessage Pekare till ett beskrivande meddelande om status för installationen som lagts till i programmets statusmeddelande. Den här parametern är begränsad till 128 tecken.

bStatus true om installationsstatusen är Lyckades.

Returvärden

Ett annat värde än noll som anger lyckades.

Anmärkningar

Installationsprogrammet (installationsprogrammet) får endast skapa en MIF-fil för installationsstatus för paketet. Filnamnet du anger måste vara unikt.

Installationer som körs på lokaliserade versioner av Configuration Manager måste ange värden i lämpligt format: ANSI-format för europeiska språk; DBCS-format för östasiatiska språk.

Programmet måste anropas InstallStatusMIF innan installationen avslutas. MIF-filen rapporteras inte till Configuration Manager om installationen skapar en annan process som anropar InstallStatusMIF.

Observera att parametrarna pszFilename, pszCompany, pszProduct, och pszVersion är direkt relaterade till egenskaperna för WMI-klassenMIFFileNameför SMS_Package-server , MIFPublisherMIFName, och MIFVersion, respektive. Dessa parametrar och egenskaper måste innehålla samma värden.

Funktionen InstallStatusMIF tillhandahålls i en 32-bitarsversion (Ismif32.dll) och en 16-bitarsversion (Ismif16.dll). Lämplig DLL installeras på klientdatorn under Configuration Manager-klientinstallationsprocessen.

Exemplet i nästa avsnitt visar hur du InstallStatusMIF anropar funktionen med hjälp av Ismif32.dll-filen direkt. Om det inte går att läsa in Ismif32.dll-filen kan det bero på att systemet inte är en Configuration Manager klient.

Exempel

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

Krav

Windows NT/2000: Windows NT 4.0 eller senare krävs.

Windows 95/98: Windows 95 eller senare krävs.

Version: Kräver SMS 2.0.

Bibliotek: Ingår som en resurs i Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Se även

Status för MIF-funktionerSMS_Package WMI-klass för server