InstallStatusMIFEx-funktion

Funktionen InstallStatusMIFEx i Configuration Manager förbättrar funktionerna i InstallStatusMIF.

Syntax

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

Parametrar

pszFileName Pekar på ett unikt namn för MIF-filen (Management Information Format). Filnamnstillägget måste vara .mif. Funktionen skriver filen till katalogen %TEMP%.

pszCompany Pekare till tillverkaren eller utgivaren av produkten, till exempel Microsoft. Den här parametern är begränsad till 64 tecken.

pszProduct Pekar på produktens eller programmets namn, till exempel Microsoft Office 2000. Den här parametern är begränsad till 64 tecken.

pszVersion Pekar på versionen av produkten, till exempel 8.0a. Den här parametern är begränsad till 64 tecken.

pszLocale Pekare till land/region eller språkkod, till exempel ENU. Den här parametern är valfri och begränsad till 16 tecken.

pszSerialNo Pekar på produktens serienummer. Den här parametern är valfri och begränsad till 64 tecken.

pszMessage Pekar på ett beskrivande meddelande om installationens status, som läggs till i programmets statusmeddelande. Den här parametern är begränsad till 128 tecken.

bStatus true om installationsstatusen lyckas.

bProgramReboots true om programmet startar om datorn.

Returvärden

Ett värde som inte är noll för att indikera lyckat resultat.

Anmärkningar

InstallStatusMIFEx är funktionellt ekvivalent med InstallStatusMIF, förutom tillägget av parametern bProgramReboot. Att använda bProgramRebootär det mest tillförlitliga sättet att skicka den här informationen till Configuration Manager, eftersom Configuration Manager kanske inte kan få rätt slutkod från processen under omstarten. Om programmet efter att ha slutfört programkörningen anger den här flaggan i MIF-filen och en omstart inte har skett väntar Configuration Manager i en minut innan något annat program startas. Detta ger tillräckligt med tid för att omstarten ska slutföras. Den här flaggan gör det också möjligt för Configuration Manager att skicka ett preliminärt statusmeddelande för programmet och sedan ett slutligt statusmeddelande efter omstarten.

Installationsprogrammet (installationsprogrammet) får bara skapa en MIF-fil för installationsstatus för paketet. Filnamnet som du anger måste vara unikt.

Installationer som körs på lokaliserade versioner av Configuration Manager måste ange värden i lämpligt format: ANSI-format för europeiska språk; DBCS format för språk i Östasien.

Programmet måste anropa InstallStatusMIFEx innan installationen avslutas. MIF-filen rapporteras inte till Configuration Manager om installationen skapar en annan process som anropar InstallStatusMIFEx.

Parametrarna pszFilename, pszCompany, pszProductoch pszVersion är direkt relaterade till egenskaperna för SMS_Package Server WMI-klassMIFFileName, , MIFPublisherMIFNamerespektive MIFVersion. Dessa parametrar och egenskaper måste innehålla samma värden.

Krav

Windows NT/2000: Kräver Windows 2000 eller senare.

Version: Kräver SMS 2003 Advanced Client.

Bibliotek: Ingår som en resurs i IsMIF32.dll (C/C++).

Se även

Status MIF FunctionsInstallStatusMIFSMS_Package, serverns WMI-klass