InstallStatusMIF 函数
函数InstallStatusMIF
(MIF) 文件创建状态管理信息格式,Configuration Manager该文件用于关联播发的安装状态。
语法
DWORD InstallStatusMIF(
char* pszFileName,
char* pszCompany,
char* pszProduct,
char* pszVersion,
char* pszLocale,
char* pszSerialNo,
char* pszMessage,
BOOL bStatus
);
参数
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
如果安装状态为成功,则为 。
返回值
指示成功的非零值。
备注
安装 (安装程序) 应用程序只能为包创建一个安装状态 MIF 文件。 指定的文件名必须唯一。
在本地化版本的 Configuration Manager 上运行的安装必须以适当的格式指定值:欧洲语言的 ANSI 格式;东亚语言的 DBCS 格式。
应用程序必须在安装退出之前调用 InstallStatusMIF
。 如果安装创建另一个调用 InstallStatusMIF
的进程,则 MIF 文件不会报告给 Configuration Manager。
请注意,参数 pszFilename
、 pszCompany
、 pszProduct
和 pszVersion
分别与 SMS_Package服务器 WMI 类 属性 MIFFileName
、 MIFPublisher
、 MIFName
和 MIFVersion
直接相关。 这些参数和属性必须包含相同的值。
函数 InstallStatusMIF
在 32 位版本 (Ismif32.dll) 和 16 位版本 (Ismif16.dll) 中提供。 在Configuration Manager客户端安装过程中,在客户端计算机上安装相应的 DLL。
下一节中的示例演示如何直接使用 Ismif32.dll 文件调用 InstallStatusMIF
函数。 加载Ismif32.dll文件失败可能表示系统不是Configuration Manager客户端。
示例
[C/C++]
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);
#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)
HINSTANCE hinst;
int RetCode;
hinst = LoadLibrary("ismif32.dll");
InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");
if (InstallStatusMIF)
{
RetCode = InstallStatusMIF("Status",
"Microsoft",
"Microsoft SQL Server 7.0",
"7.00.000",
"ENU",
NULL,
"Installation Successful",
true);
}
FreeLibrary(hinst);
要求
Windows NT/2000:需要 Windows NT 4.0 或更高版本。
Windows 95/98:需要 Windows 95 或更高版本。
版本:需要 SMS 2.0。
库:作为资源包含在 Ismif32.dll (C/C++) 中;Ismif16.dll (C/C++) 。