MessageBoxIndirectW 関数 (winuser.h)

メッセージ ボックスを作成、表示、および操作します。 メッセージ ボックスには、アプリケーション定義のメッセージ テキストとタイトル、任意のアイコン、および定義済みのプッシュ ボタンの任意の組み合わせが含まれます。

構文

int MessageBoxIndirectW(
  [in] const MSGBOXPARAMSW *lpmbp
);

パラメーター

[in] lpmbp

型: const LPMSGBOXPARAMS

メッセージ ボックスの表示に使用される情報を含む MSGBOXPARAMS 構造体へのポインター。

戻り値

型: int

関数が成功した場合、戻り値は次のいずれかのメニュー項目値になります。

メッセージ ボックスに [キャンセル] ボタンがある場合、ESC キーを押すか、[キャンセル] ボタンが選択されている場合、この関数は IDCANCEL 値を返します。 メッセージ ボックスに [キャンセル] ボタンがない場合、Esc キーを押しても効果はありません。

メッセージ ボックスを作成するのに十分なメモリがない場合、戻り値は 0 になります。

リターン コード/値	Description
IDABORT 3	[ 中止] ボタンが選択されました。
IDCANCEL 2	[キャンセル] ボタンが選択されました。
IDCONTINUE 11	[ 続行 ] ボタンが選択されました。
IDIGNORE 5	[無視] ボタンが選択されました。
IDNO 7	[ いいえ ] ボタンが選択されました。
IDOK 1	[OK] ボタンが選択されました。
IDRETRY 4	[ 再試行 ] ボタンが選択されました。
IDTRYAGAIN 10	[ 再試行] ボタンが選択されました。
IDYES 6	[ はい ] ボタンが選択されました。

注釈

システムがメモリ不足であることを示すためにシステム モーダル メッセージ ボックスを使用する場合、リソースの読み込みが失敗する可能性があるため、MSGBOXPARAMS 構造体の lpszText および lpszCaption メンバーが指す文字列をリソース ファイルから取得しないでください。

ダイアログ ボックスが表示されているときにメッセージ ボックスを作成する場合は、ダイアログ ボックスへのハンドルを hWnd パラメーターとして使用します。 hWnd パラメーターは、ダイアログ ボックス内のコントロールなどの子ウィンドウを識別しないでください。

注意

winuser.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして MessageBoxIndirect を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-dialogbox-l1-1-0 (Windows 8で導入)

関連項目

概念

ダイアログ ボックス

MSGBOXPARAMS

メッセージ ボックス

MessageBoxEx

参照