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。

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

函数 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++) 。

另请参阅

状态 MIF 函数
SMS_Package服务器 WMI 类