共用方式為

INSTALLUI_HANDLERA回呼函式 （msi.h）

  • 發行項

INSTALLUI_HANDLER 函式原型會定義安裝程式呼叫進度通知和錯誤訊息的回呼函式。 如需此函式原型使用方式的詳細資訊，使用 MsiSetExternalUI 處理進度訊息提供範例代碼段。

語法

INSTALLUI_HANDLERA InstalluiHandlera;

int InstalluiHandlera(
  LPVOID pvContext,
  UINT iMessageType,
  LPCSTR szMessage
)
{...}

參數

pvContext

傳遞至 MsiSetExternalUI 函式之應用程式內容的指標。 此參數可用於錯誤檢查。

iMessageType

指定一個消息框樣式、一個消息框圖示類型、一個預設按鈕和一個安裝訊息類型的組合。 此參數必須是下列其中一項。

消息框 StylesFlag 意義
MB_ABORTRETRYIGNORE
 消息框包含 中止、重試，以及 [忽略] 按鈕 。
MB_OK
 消息框包含 [確定] 按鈕 。 這是預設值。
MB_OKCANCEL
 消息框包含 [確定] ，以及 [取消] 按鈕 。
MB_RETRYCANCEL
 消息框包含 [重試] 和 [取消] 按鈕 。
MB_YESNO
 消息框包含 [是] [是] 和 [無] 按鈕。
MB_YESNOCANCEL
 消息框包含 [是] [是]、[否] 和 [取消] 按鈕 。
 
消息框 IconTypesFlag 意義
MB_ICONEXCLAMATION，MB_ICONWARNING
 消息框中會出現驚嘆號。
MB_ICONINFORMATION，MB_ICONASTERISK
 資訊符號會出現在消息框中。
MB_ICONQUESTION
 消息框中會出現問號。
MB_ICONSTOP、MB_ICONERROR、MB_ICONHAND
 停止符號會出現在消息框中。
 
默認 ButtonsFlag 意義
MB_DEFBUTTON1
 第一個按鈕是預設按鈕。
MB_DEFBUTTON2
 第二個按鈕是預設按鈕。
MB_DEFBUTTON3
 第三個按鈕是預設按鈕。
 
安裝訊息類型Flag 意義
INSTALLMESSAGE_FATALEXIT
 過早終止
INSTALLMESSAGE_ERROR
 格式化的錯誤訊息
INSTALLMESSAGE_WARNING
 格式化的警告訊息
INSTALLMESSAGE_USER
 使用者要求訊息。
INSTALLMESSAGE_INFO
 記錄的資訊訊息
INSTALLMESSAGE_FILESINUSE
 目前正在使用的檔案清單，這些檔案必須在取代之前關閉。
INSTALLMESSAGE_RESOLVESOURCE
 決定有效來源位置的要求
INSTALLMESSAGE_RMFILESINUSE
 目前正在使用的檔案清單，這些檔案必須在取代之前關閉。 從 Windows Installer 4.0 開始提供。 如需此訊息的詳細資訊，請參閱 使用重新啟動管理員搭配外部 UI。
INSTALLMESSAGE_OUTOFDISKSPACE
 磁碟空間不足訊息
INSTALLMESSAGE_ACTIONSTART
 動作訊息的開始。 此訊息包含動作名稱和描述。
INSTALLMESSAGE_ACTIONDATA
 與個別動作項目相關聯的格式化數據。
INSTALLMESSAGE_PROGRESS
 進度量測計資訊。 此訊息包含到目前為止單位和單位總數的相關信息。
INSTALLMESSAGE_COMMONDATA
 使用者介面的格式化對話框資訊。
INSTALLMESSAGE_INITIALIZE
 在UI初始化之前傳送，沒有字串數據
INSTALLMESSAGE_TERMINATE
 在UI終止之後傳送，沒有字串數據
INSTALLMESSAGE_SHOWDIALOG
 在顯示已撰寫對話框或精靈之前傳送
INSTALLMESSAGE_INSTALLSTART
 在安裝產品之前傳送。
INSTALLMESSAGE_INSTALLEND
 安裝產品之後傳送。
 
 

如果遺漏上述任何訊息，則應該使用下列預設值：MB_OK、沒有圖示和MB_DEFBUTTON1。 沒有預設安裝訊息類型;一律會指定訊息類型。

szMessage

指定消息正文。

傳回值

下列傳回值會對應至消息框樣式所指定的按鈕：

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

言論

如需從外部使用者介面處理程式傳回值的詳細資訊，請參閱 從外部使用者介面處理程式傳回值 主題。

注意

msi.h 標頭會將INSTALLUI_HANDLER定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目標平臺 窗戶
標頭 msi.h

另請參閱

MsiSetExternalUI