InstallStatusMIFEx 函数

InstallStatusMIFEx Configuration Manager 中的 函数增强了 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。

请注意,参数 pszFilenamepszCompanypszProductpszVersion 分别与 SMS_Package服务器 WMI 类 属性 MIFFileNameMIFPublisherMIFNameMIFVersion直接相关。 这些参数和属性必须包含相同的值。

要求

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

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

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

另请参阅

状态 MIF 函数
InstallStatusMIF
SMS_Package服务器 WMI 类