共用方式為


MessageBeep 函式 (winuser.h)

播放超聲波音效。 登錄中的項目會識別每個音效類型的超聲波音效。

 
Windows Server 2022 上的附註,工作排程器中的 Microsoft\Windows\Multimedia\SystemSoundsService 工作已停用。 必須啟用此工作,MessageBeep 才能運作。

語法

BOOL MessageBeep(
  [in] UINT uType
);

參數

[in] uType

要播放的聲音。 音效是由使用者透過 Sound 控制面板應用程式所設定,然後儲存在登錄中。

此參數可以是下列其中一個值。

價值 意義
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
0x000000020L
指定為 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

通知使用者