Auf Englisch lesen

Freigeben über


MessageBeep-Funktion (winuser.h)

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

 
Hinweis Unter Windows Server 2022 ist der Task Microsoft\Windows\Multimedia\SystemSoundsService im Taskplaner deaktiviert. Diese Aufgabe muss aktiviert werden, damit MessageBeep funktioniert.

Syntax

BOOL MessageBeep(
  [in] UINT uType
);

Parameter

[in] uType

Der wiedergegebene Sound. Die Sounds werden vom Benutzer über die Sound-Systemsteuerung festgelegt und dann in der Registrierung gespeichert.

Dieser Parameter kann einen der folgenden Werte annehmen.

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
0x00000030L
Siehe MB_ICONWARNING.
MB_ICONERROR
0x00000010L
Der als Windows Critical Stop-Sound angegebene Sound.
MB_ICONHAND
0x00000010L
Siehe MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
Der als Windows-Sternchen-Sound angegebene Sound.
MB_ICONQUESTION
0x00000020L
Der als Windows-Fragesound angegebene Sound.
MB_ICONSTOP
0x00000010L
Siehe MB_ICONERROR.
MB_ICONWARNING
0x00000030L
Der als Windows-Ausrufezeichen-Sound angegebene Sound.
MB_OK
0x00000000L
Der als Windows-Standardton "Signalton" angegebene Sound.

Rückgabewert

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

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

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

Wenn der angegebene Warnungssound nicht wiedergegeben werden kann, versucht MessageBeep , den Standardsound des Systems wiederzugeben. Wenn der Standardsound des Systems nicht wiedergegeben werden kann, erzeugt die Funktion einen Standard-Signalton über den Computerlautsprecher.

Der Benutzer kann den Signalton mit der Sound-Systemsteuerung deaktivieren.

Hinweis Verwenden Sie die Beep-Funktion , um einen Signalton an einen Remoteclient zu senden. Die Beep-Funktion wird an den Client umgeleitet, MessageBeep hingegen nicht.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-misc-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

Beep

Fehlerbehandlungsfunktionen

FlashWindow

Benachrichtigen des Benutzers