MessageBeep function

Plays a waveform sound. The waveform sound for each sound type is identified by an entry in the registry.

Syntax


BOOL WINAPI MessageBeep(
  _In_  UINT uType
);

Parameters

uType [in]

The sound to be played. The sounds are set by the user through the Sound control panel application, and then stored in the registry.

This parameter can be one of the following values.

ValueMeaning

0xFFFFFFFF

A simple beep. If the sound card is not available, the sound is generated using the speaker.

MB_ICONASTERISK
0x00000040L

See MB_ICONINFORMATION.

MB_ICONEXCLAMATION
0x00000030L

See MB_ICONWARNING.

MB_ICONERROR
0x00000010L

The sound specified as the Windows Critical Stop sound.

MB_ICONHAND
0x00000010L

See MB_ICONERROR.

MB_ICONINFORMATION
0x00000040L

The sound specified as the Windows Asterisk sound.

MB_ICONQUESTION
0x00000020L

The sound specified as the Windows Question sound.

MB_ICONSTOP
0x00000010L

See MB_ICONERROR.

MB_ICONWARNING
0x00000030L

The sound specified as the Windows Exclamation sound.

MB_OK
0x00000000L

The sound specified as the Windows Default Beep sound.

 

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

After queuing the sound, the MessageBeep function returns control to the calling function and plays the sound asynchronously.

If it cannot play the specified alert sound, MessageBeep attempts to play the system default sound. If it cannot play the system default sound, the function produces a standard beep sound through the computer speaker.

The user can disable the warning beep by using the Sound control panel application.

Note  To send a beep to a remote client, use the Beep function. The Beep function is redirected to the client, whereas MessageBeep is not.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

WinUser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Beep
Error Handling Functions
FlashWindow
Notifying the User

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.