通过

InstallStatusMIFEx 函数

Configuration Manager InstallStatusMIFEx 中的 函数增强了 InstallStatusMIF 的功能。

语法

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

参数

pszFileName 指向管理信息格式 (MIF) 文件的唯一名称的指针。 文件扩展名必须为 .mif。 函数将文件写入 %TEMP% 目录。

pszCompany 指向产品的制造商或发布者的指针，例如，Microsoft。 此参数限制为 64 个字符。

pszProduct 指向产品或程序名称的指针，例如，Microsoft Office 2000。 此参数限制为 64 个字符。

pszVersion 指向产品版本的指针，例如 8.0a。 此参数限制为 64 个字符。

pszLocale 指向国家/地区或语言代码（例如 ENU）的指针。 此参数是可选的，限制为 16 个字符。

pszSerialNo 指向产品的序列号的指针。 此参数是可选的，限制为 64 个字符。

pszMessage 指向有关安装状态的描述性消息的指针，该消息将添加到程序状态消息中。 此参数限制为 128 个字符。

bStatus true 如果安装状态为成功，则为 。

bProgramReboots true 如果程序将重新启动计算机，则为 。

返回值

指示成功的非零值。

备注

InstallStatusMIFEx 在功能上等效于 InstallStatusMIF，除了添加 bProgramReboot参数。 使用 bProgramReboot是将此信息传递给Configuration Manager的最可靠方法，因为在重新启动期间，Configuration Manager可能无法从进程中获取正确的退出代码。 如果在完成程序执行后，程序在 MIF 文件中设置了此标志，并且未重新启动，Configuration Manager等待一分钟，然后再启动任何其他程序。 这为重新启动提供了足够的时间来完成。 此标志还允许Configuration Manager发送程序的初步成功状态消息，然后在重新启动后发送最终成功状态消息。

安装 (安装程序) 应用程序只能为包创建一个安装状态 MIF 文件。 指定的文件名必须唯一。

在本地化版本的 Configuration Manager 上运行的安装必须以适当的格式指定值：欧洲语言的 ANSI 格式;东亚语言DBCS格式。

应用程序必须在安装退出之前调用 InstallStatusMIFEx 。 如果安装创建另一个调用 InstallStatusMIFEx的进程，则 MIF 文件不会报告给 Configuration Manager。

参数 pszFilename、 pszCompany、 pszProduct和 pszVersion 分别与 SMS_Package服务器 WMI 类 属性 MIFFileName、 MIFPublisher、 MIFName和 MIFVersion直接相关。 这些参数和属性必须包含相同的值。

要求

Windows NT/2000：需要 Windows 2000 或更高版本。

版本：需要 SMS 2003 高级客户端。

库：作为资源包含在 IsMIF32.dll (C/C++) 中。

另请参阅

Status MIF FunctionsInstallStatusMIFSMS_Package Server WMI 类