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
Wijzer naar de fabrikant of uitgever van het product, 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 pszFilename, pszCompany, pszProducten pszVersion rechtstreeks zijn gerelateerd aan respectievelijk de eigenschappen van de WMI-klasseMIFFileNameSMS_Package server , MIFPublisher, MIFNameen MIFVersion. 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++).