MessageBeep

Syntax

void MessageBeep(wAlert)

This function plays a waveform sound corresponding to a given system alert level. The sound for each alert level is identified by an entry in the [sounds] section of WIN.INI.

Parameters

WORD wAlert

Specifies the alert level. Use one of the following values:

MB_OK

Plays the sound identified by the “SystemDefault” entry in the [sounds] section of WIN.INI.

MB_ICONASTERISK

Plays the sound identified by the “SystemAsterisk” entry in the [sounds] section of WIN.INI.

MB_ICONEXCLAMATION

Plays the sound identified by the “SystemExclamation” entry in the [sounds] section of WIN.INI.

MB_ICONHAND

Plays the sound identified by the “SystemHand” entry in the [sounds] section of WIN.INI.

MB_ICONQUESTION

Plays the sound identified by the “SystemQuestion” entry in the [sounds] section of WIN.INI.

0

Plays the sound identified by the “SystemDefault” entry in the [sounds] section of WIN.INI.

-1

Produces a standard beep sound using the computer speaker.

Return Value

None

Comments

MessageBeep returns control to the caller after queuing the sound and plays the sound asynchronously.

If the specified alert sound can't be played, MessageBeep tries to play the system default sound. If the system default sound can't be played, it produces a standard beep sound using the computer speaker.

The user can disable the warning beep using the Sounds control-panel applet.

See Also

sndPlaySound