InstallStatusMIFEx, functie

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

pszSerialNo Pointer naar het serienummer van het product. Deze parameter is optioneel en kan maximaal 64 tekens bevatten.

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

bProgramReboots true of het programma de computer opnieuw opstart.

Retourwaarden

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

Opmerkingen

InstallStatusMIFEx is functioneel equivalent aan InstallStatusMIF, behalve de toevoeging van de bProgramRebootparameter. Dit bProgramRebootis de meest betrouwbare manier om deze informatie door te geven aan Configuration Manager, omdat Configuration Manager tijdens het opnieuw opstarten mogelijk niet de juiste afsluitcode van het proces kan ophalen. Als na het voltooien van de uitvoering van het programma deze vlag wordt ingesteld in het MIF-bestand en er geen herstart heeft plaatsgevonden, wacht Configuration Manager één minuut voordat een ander programma wordt gestart. Op deze manier is er voldoende tijd om het opnieuw opstarten te voltooien. Met deze vlag kan Configuration Manager ook een voorlopig bericht over de succesvolle status van het programma verzenden en vervolgens een laatste successtatusbericht nadat opnieuw is opgestart.

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

De parameters pszFilename, pszCompany, pszProduct, en pszVersion zijn rechtstreeks gerelateerd aan de eigenschappen MIFFileNamevan de WMI-klasse van SMS_Package Server , MIFPublisher, MIFNamerespectievelijk MIFVersion, . 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: MIT, functies: InstallStatusMIT,SMS_Package Server WMI-klasse