InstallStatusMIF, functie

Met de InstallStatusMIF functie wordt een MIF-bestand (Status Management Information Format) gemaakt dat Configuration Manager gebruikt om de installatiestatus voor een advertentie te correleren.

Syntaxis

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

Parameters

pszFileName Wijs een unieke naam aan voor het MIF-bestand. Een bestandsnaamextensie moet .mif zijn. De functie schrijft het bestand naar de map %TEMP%.

pszCompany Wijs de fabrikant of uitgever van het product aan, bijvoorbeeld Microsoft. Deze parameter is beperkt tot 64 tekens.

pszProduct Aanwijzer naar de product- of programmanaam, bijvoorbeeld Microsoft Office 2000. Deze parameter is beperkt tot 64 tekens.

pszVersion Aanwijzer naar de versie van het product, bijvoorbeeld 8.0a. Deze parameter is beperkt tot 64 tekens.

pszLocale Wijzer naar het land/de regio of taalcode, bijvoorbeeld ENU. Deze parameter is optioneel en is beperkt tot 16 tekens.

pszSerialNo Aanwijzer naar het serienummer van het product. Deze parameter is optioneel en is beperkt tot 64 tekens.

pszMessage Aanwijzer naar een beschrijvend bericht over de status van de installatie, toegevoegd aan het statusbericht van het programma. Deze parameter is beperkt tot 128 tekens.

bStatus true als de installatiestatus geslaagd is.

Retourwaarden

Een niet-nulwaarde om aan te geven dat het is gelukt.

Opmerkingen

Uw installatietoepassing (setup) mag slechts één MIF-bestand met de installatiestatus voor het pakket maken. De bestandsnaam die u opgeeft, moet uniek zijn.

Installaties die worden uitgevoerd op gelokaliseerde versies van Configuration Manager moeten waarden opgeven in de juiste indeling: ANSI-indeling voor Europese talen; DBCS indeling voor oost-Aziatische talen.

Uw toepassing moet aanroepen InstallStatusMIF voordat de installatie wordt afgesloten. Het MIF-bestand wordt niet gerapporteerd aan Configuration Manager als de installatie een ander proces maakt dat aanroeptInstallStatusMIF.

Houd er rekening mee dat de parameters , , en rechtstreeks zijn gerelateerd aan respectievelijk de WMI-klasse-eigenschappen van de SMS_Package-server, MIFPublisher, MIFNameen MIFVersion.MIFFileNamepszVersionpszProductpszCompanypszFilename Deze parameters en eigenschappen moeten dezelfde waarden bevatten.

De InstallStatusMIF functie wordt geleverd in een 32-bits versie (Ismif32.dll) en een 16-bits versie (Ismif16.dll). De juiste DLL wordt geïnstalleerd op de clientcomputer tijdens het Configuration Manager clientinstallatieproces.

In het voorbeeld in de volgende sectie ziet u hoe u de InstallStatusMIF functie rechtstreeks kunt aanroepen met behulp van het Ismif32.dll-bestand. Een fout bij het laden van het Ismif32.dll-bestand kan erop wijzen dat het systeem geen Configuration Manager-client is.

Voorbeeld

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

Vereisten

Windows NT/2000: Vereist Windows NT 4.0 of hoger.

Windows 95/98: Hiervoor is Windows 95 of hoger vereist.

Versie: hiervoor is SMS 2.0 vereist.

Bibliotheek: opgenomen als een resource in Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Zie ook

Status VAN MIF-functiesSMS_Package-server WMI-klasse