Edit

Share via

InstallStatusMIFEx Function

  • Article

The InstallStatusMIFEx function, in Configuration Manager, enhances the functionality of InstallStatusMIF.

Syntax

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

Parameters

pszFileName
Pointer to a unique name for the Management Information Format (MIF) file. A file name extension must be .mif. The function writes the file to the %TEMP% directory.

pszCompany
Pointer to the manufacturer or publisher of the product, for example, Microsoft. This parameter is limited to 64 characters.

pszProduct
Pointer to the product or program name, for example, Microsoft Office 2000. This parameter is limited to 64 characters.

pszVersion
Pointer to the version of the product, for example, 8.0a. This parameter is limited to 64 characters.

pszLocale
Pointer to the country/region or language code, for example, ENU. This parameter is optional and limited to 16 characters.

pszSerialNo
Pointer to the serial number of the product. This parameter is optional and limited to 64 characters.

pszMessage
Pointer to a descriptive message about the status of the installation, which is added to the program status message. This parameter is limited to 128 characters.

bStatus
true if the install status is success.

bProgramReboots
true if the program will reboot the computer.

Return Values

A non-zero value to indicate success.

Remarks

InstallStatusMIFEx is functionally equivalent to InstallStatusMIF, except for the addition of the bProgramRebootparameter. Using bProgramRebootis the most reliable way of passing this information to Configuration Manager, because during reboot Configuration Manager might not be able to get the correct exit code from the process. If, after completing program execution, the program sets this flag in the MIF file and a reboot hasn't happened, Configuration Manager waits for one minute before launching any other program. This allows enough time for the reboot to finish. This flag also enables Configuration Manager to send a preliminary success status message for the program and then a final success status message after the reboot has occurred.

Your installation (setup) application must create only one install status MIF file for the package. The file name that you specify must be unique.

Installations that run on localized versions of Configuration Manager must specify values in the appropriate format: ANSI format for European languages; DBCS format for East Asia languages.

Your application must call InstallStatusMIFEx before the installation exits. The MIF file isn't reported to Configuration Manager if the installation creates another process that calls InstallStatusMIFEx.

The parameters pszFilename, pszCompany, pszProduct, and pszVersion are directly related to the SMS_Package Server WMI Class properties MIFFileName, MIFPublisher, MIFName, and MIFVersion, respectively. These parameters and properties must contain the same values.

Requirements

Windows NT/2000: Requires Windows 2000 or later.

Version: Requires SMS 2003 Advanced Client.

Library: Included as a resource in IsMIF32.dll (C/C++).

See Also

Status MIF Functions
InstallStatusMIF
SMS_Package Server WMI Class