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++) 中的資源。