InstallStatusMIFEx, functie

De InstallStatusMIFEx functie in Configuration Manager verbetert de functionaliteit van InstallStatusMIF.

Syntaxis

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

Parameters

pszFileName Wijs een unieke naam aan voor het MIF-bestand (Management Information Format). 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 beperkt tot 16 tekens.

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

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

bStatus true als de installatiestatus geslaagd is.

bProgramReboots true als het programma de computer opnieuw opstart.

Retourwaarden

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

Opmerkingen

InstallStatusMIFEx is functioneel gelijk aan InstallStatusMIF, met uitzondering van de toevoeging van de bProgramRebootparameter. Gebruik bProgramRebootis de meest betrouwbare manier om deze informatie door te geven aan Configuration Manager, omdat tijdens het opnieuw opstarten Configuration Manager mogelijk niet de juiste afsluitcode uit het proces kunt ophalen. Als het programma na het uitvoeren van het programma deze vlag instelt in het MIF-bestand en er niet opnieuw is opgestart, wacht Configuration Manager één minuut voordat een ander programma wordt gestart. Dit geeft voldoende tijd voordat het opnieuw opstarten is voltooid. Met deze vlag kan Configuration Manager ook een voorlopig statusbericht voor het programma verzenden en vervolgens een definitief bericht over de status van geslaagd nadat het opnieuw opstarten is opgetreden.

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 InstallStatusMIFEx voordat de installatie wordt afgesloten. Het MIF-bestand wordt niet gerapporteerd aan Configuration Manager als de installatie een ander proces aanroeptInstallStatusMIFEx.

De parameters pszFilename, pszCompany, pszProducten pszVersion zijn rechtstreeks gerelateerd aan respectievelijk de WMI-klasse-eigenschappen van de SMS_Package-server, MIFPublisher, MIFNameen MIFVersion.MIFFileName Deze parameters en eigenschappen moeten dezelfde waarden bevatten.

Vereisten

Windows NT/2000: Vereist Windows 2000 of hoger.

Versie: Vereist SMS 2003 Advanced Client.

Bibliotheek: opgenomen als een resource in IsMIF32.dll (C/C++).

Zie ook

Status MIF FunctionsInstallStatusMIFSMS_Package-server WMI-klasse