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 格式;BIG5 東亞語言的格式。
您的應用程式必須在安裝結束之前呼叫 InstallStatusMIFEx 。 如果安裝建立另一個呼叫 InstallStatusMIFEx的進程,則不會向 Configuration Manager 報告 MIF 檔案。
、pszCompany、 pszProduct和 pszVersion 參數pszFilename分別與 SMS_Package Server WMI 類別屬性 MIFFileName、MIFPublisher、 MIFName和 MIFVersion直接相關。 這些參數和屬性必須包含相同的值。
需求
Windows NT/2000:需要 Windows 2000 或更新版本。
版本:需要SMS 2003進階用戶端。
連結庫:包含為 IsMIF32.dll (C/C++) 中的資源。