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。
请注意,参数 pszFilename
、 pszCompany
、 pszProduct
和 pszVersion
分别与 SMS_Package服务器 WMI 类 属性 MIFFileName
、 MIFPublisher
、 MIFName
和 MIFVersion
直接相关。 这些参数和属性必须包含相同的值。
要求
Windows NT/2000:需要 Windows 2000 或更高版本。
版本:需要 SMS 2003 高级客户端。
库:作为资源包含在 IsMIF32.dll (C/C++) 中。