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。
參數 pszFilename、 pszCompany和 pszProduct分別pszVersion與 SMS_Package Server WMI 類別屬性 MIFFileName、 MIFPublisherMIFNameMIFVersion和 直接相關。 這些參數和屬性必須包含相同的值。
需求
Windows NT/2000：需要 Windows 2000 或更新版本。
版本：需要 SMS 2003 Advanced 用戶端。
程式庫：作為資源包含在 IsMIF32.dll (C/C++) 中。