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

  • [アーティクル]

外部のユーザー インターフェイス (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 ([無視] ボタンが押された)