分享方式：

InstallStatusMIFEx 函式

  • 文章

Configuration Manager 中的函InstallStatusMIFEx式會增強 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。

、pszCompany、 pszProduct和 pszVersion 參數pszFilename分別與 SMS_Package Server WMI 類別屬性 MIFFileName、MIFPublisher、 MIFName和 MIFVersion直接相關。 這些參數和屬性必須包含相同的值。

需求

Windows NT/2000：需要 Windows 2000 或更新版本。

版本：需要SMS 2003進階用戶端。

連結庫：包含為 IsMIF32.dll (C/C++) 中的資源。

另請參閱

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