MessageBeep 関数 (winuser.h)

波形サウンドを再生します。各サウンドの種類の波形サウンドは、レジストリのエントリによって識別されます。

メモ Windows Server 2022 では、タスクスケジューラの Microsoft\Windows\Multimedia\SystemSoundsService タスクが無効になっています。 MessageBeep が機能するには、このタスクを有効にする必要があります。

構文

BOOL MessageBeep(
  [in] UINT uType
);

[in] uType

再生するサウンド。サウンドは、サウンドコントロールパネルアプリケーションを使用してユーザーによって設定され、レジストリに格納されます。

このパラメーターには、次の値のいずれかを指定できます。

値	意味
0xFFFFFFFF	単純なビープ音。サウンドカードが使用できない場合は、スピーカーを使用してサウンドが生成されます。
MB_ICONASTERISK 0x00000040L	「MB_ICONINFORMATION」を参照してください。
MB_ICONEXCLAMATION 0x00000030L	「MB_ICONWARNING」を参照してください。
MB_ICONERROR 0x00000010L	Windows Critical Stop サウンドとして指定されたサウンド。
MB_ICONHAND 0x00000010L	「MB_ICONERROR」を参照してください。
MB_ICONINFORMATION 0x00000040L	Windows アスタリスクサウンドとして指定されたサウンド。
MB_ICONQUESTION 0x00000020L	Windows 質問のサウンドとして指定されたサウンド。
MB_ICONSTOP 0x00000010L	「MB_ICONERROR」を参照してください。
MB_ICONWARNING 0x00000030L	Windows 感嘆符として指定されたサウンド。
MB_OK 0x000000000L	Windows の既定のビープ音として指定されたサウンド。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

サウンドをキューに入れると、 MessageBeep 関数は呼び出し元の関数に制御を返し、サウンドを非同期的に再生します。

指定したアラートサウンドを再生できない場合、 MessageBeep はシステムの既定のサウンドの再生を試みます。システムの既定のサウンドを再生できない場合、関数はコンピュータースピーカーを介して標準のビープ音を生成します。

ユーザーは、サウンドコントロールパネルアプリケーションを使用して警告ビープ音を無効にすることができます。

メモビープ音をリモートクライアントに送信するには、 Beep 関数を使用します。 Beep 関数はクライアントにリダイレクトされますが、MessageBeep はリダイレクトされません。


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