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 关键停止声音的声音。
MB_ICONHAND
0x00000010L
请参阅 MB_ICONERROR
MB_ICONINFORMATION
0x00000040L
指定为 Windows 星号声音的声音。
MB_ICONQUESTION
0x00000020L
指定为 Windows 问题声音的声音。
MB_ICONSTOP
0x00000010L
请参阅 MB_ICONERROR
MB_ICONWARNING
0x00000030L
指定为 Windows 感叹号声音的声音。
MB_OK
0x00000000L
指定为 Windows 默认蜂鸣声的声音。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError

言论

在排队声音后,MessageBeep 函数将控制权返回到调用函数,并异步播放声音。

如果无法播放指定的警报声音,MessageBeep 尝试播放系统默认声音。 如果无法播放系统默认声音,该函数将使用 Beep 函数生成标准蜂鸣声。 从 Windows 7 开始,这将在默认声音设备上播放简单的音调。 有关更多详细信息,请参阅 Beep 函数的文档。

用户可以使用声音控制面板应用程序禁用警告蜂鸣。

注意 若要向远程客户端发送蜂鸣声,请使用 Beep 函数。 Beep 函数将重定向到客户端,而 MessageBeep 则不是。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 winuser.h (包括 Windows.h)
User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-misc-l1-1-0(在 Windows 8 中引入)

另请参阅

蜂鸣声

错误处理函数

FlashWindow

通知用户