外部のユーザー インターフェイス ハンドラーから返される値

外部のユーザー インターフェイス (UI) ハンドラーでは、インストーラーでハンドラーに渡されるメッセージ型パラメーターで指定されたボタンの種類に応じて、任意の数の値を Windows インストーラーに返すことができます。

外部の UI ハンドラーでは、いつでも値 –1 と 0 を返すことができます。これは、これらがボタンの種類に関連していないためです。 戻り値 –1 は、外部の UI ハンドラーで内部エラーが発生したことを示します。 戻り値 0 は、外部の UI ハンドラーがインストーラー メッセージを処理していないため、インストーラーが代わりにメッセージを処理する必要があることを示します。

INSTALLMESSAGE_ACTIONDATA や INSTALLMESSAGE_PROGRESS など、ボタンの種類が含まれていないメッセージの場合、返される IDCANCEL によってインストールが取り消されます。 IDOK を返された場合、メッセージが外部の UI ハンドラーによって処理されたことがインストーラーに通知されます。

以下で説明する残りの戻り値は、メッセージの種類に含まれるボタンの種類に直接関連しています。

外部 UI の戻り値	説明
IDOK	ユーザーが [OK] ボタンを押しました。 メッセージ情報が理解されました。
IDCANCEL	[キャンセル] ボタンが押されました。 インストールを取り消します。
IDABORT	[中止] ボタンが押されました。 インストールを中止します。
IDRETRY	[再試行] ボタンが押されました。 操作を再度実行します。
IDIGNORE	[無視] ボタンが押されました。 エラーを無視して続行します。
IDYES	[はい] ボタンが押されました。 肯定の応答です。現在の一連のイベントを続行します。
IDNO	[いいえ] ボタンが押されました。 否定の応答です。現在の一連のイベントは続行されません。

 

たとえば、外部 UI ハンドラーに MB_ABORTRETRYIGNORE メッセージ ボックス スタイル フラグを持つメッセージが送信された場合、外部 UI ハンドラーは次のいずれかの値を返すことができます。

• –1 (外部 UI ハンドラーでのエラー)
• 0 (外部 UI ハンドラーでは何も行われず、Windows インストーラーで処理できるようにする)
• IDABORT ([中止] ボタンが押された)
• IDRETRY ([再試行] ボタンが押された)
• IDIGNORE ([無視] ボタンが押された)