Freigeben über

MessageBeep-Funktion (winuser.h)

  • Artikel

Gibt einen Wellenformsound wieder. Der Wellenformsound für jeden Soundtyp wird durch einen Eintrag in der Registrierung identifiziert.

 
Hinweis Unter Windows Server 2022 ist die Aufgabe "Microsoft\Windows\Multimedia\SystemSoundsService" in "Task Scheduler" deaktiviert. Diese Aufgabe muss aktiviert sein, damit MessageBeep funktioniert.

Syntax

BOOL MessageBeep(
  [in] UINT uType
);

Parameter

[in] uType

Der sound, der wiedergegeben werden soll. Die Sounds werden vom Benutzer über die Sound-Systemsteuerungsanwendung festgelegt und dann in der Registrierung gespeichert.

Dieser Parameter kann einer der folgenden Werte sein:

Wert Bedeutung
0xFFFFFFFF Ein einfacher Signalton. Wenn die Soundkarte nicht verfügbar ist, wird der Sound mithilfe des Lautsprechers generiert.
MB_ICONASTERISK
0x00000040L
 Siehe MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x000000030L
 Siehe MB_ICONWARNING.
MB_ICONERROR
0x000000010L
 Der als Windows Critical Stop-Sound angegebene Sound.
MB_ICONHAND
0x000000010L
 Siehe MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Der als Windows-Sternchen angegebene Sound.
MB_ICONQUESTION
0x000000020L
 Der als Windows-Fragesound angegebene Sound.
MB_ICONSTOP
0x000000010L
 Siehe MB_ICONERROR.
MB_ICONWARNING
0x000000030L
 Der als Windows-Ausrufezeichen angegebene Sound.
MB_OK
0x000000000L
 Der als Windows Default Beep sound angegebene Sound.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Nach der Warteschlange des Sounds gibt die MessageBeep--Funktion die Steuerung an die aufrufende Funktion zurück und gibt den Sound asynchron wieder.

Wenn der angegebene Benachrichtigungssound nicht wiedergegeben werden kann, MessageBeep versucht, den Standardsound des Systems wiederzugeben. Wenn der Standardsound des Systems nicht wiedergegeben werden kann, erzeugt die Funktion einen Standardtonton mit der Beep--Funktion. Ab Windows 7 spielt dies einen einfachen Ton auf dem Standardsoundgerät. Weitere Details finden Sie in der Dokumentation zur funktion Beep.

Der Benutzer kann den Warnton mithilfe der Sound-Systemsteuerungsanwendung deaktivieren.

Hinweis Verwenden Sie zum Senden eines Signaltons an einen Remoteclient die funktion Signalton. Die Beep--Funktion wird an den Client umgeleitet, während MessageBeep- nicht.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- winuser.h (enthalten Windows.h)
Library User32.lib
DLL- User32.dll
API-Satz ext-ms-win-ntuser-misc-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Signalton-

Fehlerbehandlungsfunktionen

FlashWindow-

benachrichtigen den Benutzer