InstallStatusMIF, functie

Met deze InstallStatusMIF functie wordt een MIF-bestand (Management Information Format) gemaakt, dat door Configuration Manager wordt gebruikt om de installatiestatus van een aankondiging te correleren.

Syntaxis

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

Parameters

pszFileName Pointer naar een unieke naam voor het MIF-bestand. De bestandsextensie moet .mif zijn. De functie schrijft het bestand naar de map %TEMP%.

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

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

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

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

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

pszMessage Verwijzing 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 is gelukt.

Retourwaarden

Een niet-nulwaarde om aan te geven dat een succes is geslaagd.

Opmerkingen

Uw installatietoepassing (installatietoepassing) moet slechts één MIT-bestand met de installatiestatus voor het pakket maken. De opgegeven bestandsnaam 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.

De toepassing moet aanroepen InstallStatusMIF voordat de installatie wordt afgesloten. Het MIT-bestand wordt niet gerapporteerd aan Configuration Manager als tijdens de installatie een ander proces wordt gemaakt dat aanroeptInstallStatusMIF.

De parameters pszFilename, pszCompany, pszProduct, en pszVersion zijn rechtstreeks gerelateerd aan de eigenschappen MIFFileNamevan de WMI-klasse van SMS_Package Server , MIFPublisher, MIFName, en MIFVersion, respectievelijk. 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). Het juiste DLL-bestand wordt op de clientcomputer geïnstalleerd tijdens het installatieproces van de Configuration Manager-client.

In het voorbeeld in de volgende sectie ziet u hoe u de InstallStatusMIF functie rechtstreeks aanroept met behulp van het Ismif32.dll bestand. Als het Ismif32.dll bestand niet kan worden geladen, kan dit 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: vereist Windows 95 of hoger.

Versie: vereist SMS 2.0.

Bibliotheek: Opgenomen als bron in Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Zie ook

Status MIT-functiesSMS_Package Server WMI-klasse