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 函数。 Beep 函数重定向到客户端，而 MessageBeep 则不重定向到客户端。

要求

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

请参阅

提示音

错误处理函数

FlashWindow

通知用户