INSTALLUI_HANDLERA
コールバックシグネチャ
INT INSTALLUI_HANDLERA(
void* pvContext,
DWORD iMessageType,
LPSTR szMessage
);パラメーター
| フィールド | 型 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pvContext | void* | MsiSetExternalUI 関数に渡されたアプリケーションコンテキストへのポインター。このパラメーターはエラーチェックに使用できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| iMessageType | DWORD | 1 つのメッセージボックススタイル、1 つのメッセージボックスアイコンの種類、1 つの既定のボタン、および 1 つのインストールメッセージの種類の組み合わせを指定します。このパラメーターは、次のいずれかである必要があります。
上記のメッセージのいずれかが指定されていない場合は、次の既定値が使用されます: MB_OK、アイコンなし、MB_DEFBUTTON1。インストールメッセージの種類に既定値はありません。メッセージの種類は常に指定されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| szMessage | LPSTR | メッセージのテキストを指定します。 |
公式ドキュメント
INSTALLUI_HANDLER 関数プロトタイプは、進行状況の通知とエラーメッセージのためにインストーラーが呼び出すコールバック関数を定義します。この関数プロトタイプの使用方法の詳細およびサンプルコードについては、 Handling Progress Messages Using MsiSetExternalUI を参照してください。
戻り値
次の戻り値は、メッセージボックススタイルで指定されたボタンに対応します:
IDOK
解説(Remarks)
外部ユーザーインターフェイスハンドラーから値を返す方法の詳細については、 Returning Values from an External User Interface Handler のトピックを参照してください。
msi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、INSTALLUI_HANDLER を定義します。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)