MessageBeep-Funktion (winuser.h)
Gibt einen Wellenformsound wieder. Der Wellenformsound für jeden Soundtyp wird durch einen Eintrag in der Registrierung identifiziert.
BOOL MessageBeep(
[in] UINT uType
);
[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. |
|
Siehe MB_ICONINFORMATION. |
|
Siehe MB_ICONWARNING. |
|
Der als Windows Critical Stop-Sound angegebene Sound. |
|
Siehe MB_ICONERROR. |
|
Der als Windows-Sternchen-Sound angegebene Sound. |
|
Der als Windows-Fragesound angegebene Sound. |
|
Siehe MB_ICONERROR. |
|
Der als Windows-Ausrufezeichen-Sound angegebene Sound. |
|
Der als Windows-Standardton "Signalton" angegebene Sound. |
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.
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.
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) |