共用方式為


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 格式;BIG5 東亞語言的格式。

您的應用程式必須在安裝結束之前呼叫 InstallStatusMIFEx 。 如果安裝建立另一個呼叫 InstallStatusMIFEx的進程,則不會向 Configuration Manager 報告 MIF 檔案。

pszCompanypszProductpszVersion 參數pszFilename分別與 SMS_Package Server WMI 類別屬性 MIFFileNameMIFPublisherMIFNameMIFVersion直接相關。 這些參數和屬性必須包含相同的值。

需求

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

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

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

另請參閱

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