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 的進程，則不會向Configuration Manager報告 MIF 檔案。

請注意，、 pszCompany 、 pszProduct 和 pszVersion 參數 pszFilename 分別與SMS_Package Server 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++) 。

另請參閱

狀態 MIF 函式
SMS_Package伺服器 WMI 類別