INSTALLUI_HANDLERW
コールバックシグネチャ
INT INSTALLUI_HANDLERW(
void* pvContext,
DWORD iMessageType,
LPWSTR szMessage
);パラメーター
| フィールド | 型 | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pvContext | void* | MsiSetExternalUI 関数に渡されたアプリケーションコンテキストへのポインターです。このパラメーターはエラーチェックに使用できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| iMessageType | DWORD | メッセージボックスのスタイル、メッセージボックスのアイコンの種類、既定のボタン、インストールメッセージの種類を、それぞれ 1 つずつ組み合わせて指定します。このパラメーターには、次のいずれかを指定する必要があります。
上記のメッセージのいずれかが指定されていない場合は、次の既定値が使用されます: MB_OK、アイコンなし、MB_DEFBUTTON1。インストールメッセージの種類に既定値はなく、メッセージの種類は常に指定されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| szMessage | LPWSTR | メッセージのテキストを指定します。 |
公式ドキュメント
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)