Share via


InstallStatusMIFEx Function

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

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

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 that Configuration Manager has started has finished execution and initiated a reboot.

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 has not 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 is not reported to Configuration Manager if the installation creates another process that calls InstallStatusMIFEx.

Note that 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

Concepts

Status MIF Functions
InstallStatusMIF Function
SMS_Package Server WMI Class