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
0x00000000L
 指定為 Windows 預設嗶聲音效的音效。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

將音效排入佇列之後， MessageBeep 函式會將控制權傳回呼叫函式，並以非同步方式播放音效。

如果無法播放指定的警示音效， MessageBeep 會嘗試播放系統預設音效。 如果無法播放系統預設音效，函式會透過電腦喇叭產生標準嗶聲。

使用者可以使用音效控制台應用程式來停用警告嗶聲。

注意 若要將嗶聲傳送至遠端用戶端，請使用 Beep 函式。 Beep函式會重新導向至用戶端，而 MessageBeep則不會。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平臺 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
DLL User32.dll
API 集合 ext-ms-win-ntuser-misc-l1-1-0 (在 Windows 8) 中引進

另請參閱

Beep

錯誤處理函式

FlashWindow

通知使用者