次の方法で共有


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で導入)

関連項目

Beep

エラー処理関数

FlashWindow

ユーザーへの通知