Funzione MessageBeep (winuser.h)

  • Articolo

Riproduce un suono waveform. Il suono waveform per ogni tipo di suono viene identificato da una voce nel Registro di sistema.

 
Nota In Windows Server 2022 l'attività Microsoft\Windows\Multimedia\SystemSoundsService in Task Scheduler è disabilitata. Questa attività deve essere abilitata per la funzione MessageBeep.

Sintassi

BOOL MessageBeep(
  [in] UINT uType
);

Parametri

[in] uType

Il suono da riprodurre. I suoni vengono impostati dall'utente tramite l'applicazione Pannello di controllo suono e quindi archiviati nel Registro di sistema.

Questo parametro può avere uno dei valori seguenti.

Valore Significato
0xffffffff Un semplice segnale acustico. Se la scheda audio non è disponibile, il suono viene generato usando l'altoparlante.
MB_ICONASTERISK
0x00000040L
 Vedere MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x0000030L
 Vedere MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 Suono specificato come suono Windows Critical Stop.
MB_ICONHAND
0x00000010L
 Vedere MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Suono specificato come suono di Windows Asterisco.
MB_ICONQUESTION
0x00000020L
 Suono specificato come suono di Windows Question.
MB_ICONSTOP
0x00000010L
 Vedere MB_ICONERROR.
MB_ICONWARNING
0x0000030L
 Suono specificato come suono esclamativo di Windows.
MB_OK
0x00000000L
 Suono specificato come suono Beep predefinito di Windows.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Dopo aver accodato il suono, la funzione MessageBeep restituisce il controllo alla funzione chiamante e riproduce il suono in modo asincrono.

Se non è in grado di riprodurre il suono di avviso specificato, MessageBeep tenta di riprodurre il suono predefinito del sistema. Se non è in grado di riprodurre il suono predefinito del sistema, la funzione produce un suono acustico standard tramite l'altoparlante del computer.

L'utente può disabilitare l'avviso tramite l'applicazione Pannello di controllo Audio.

Nota Per inviare un segnale acustico a un client remoto, usare la funzione Beep . La funzione Beep viene reindirizzata al client, mentre MessageBeep non è.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-misc-l1-1-0 (introdotto in Windows 8)

Vedi anche

Beep

Funzioni di gestione degli errori

Flashwindow

Notifica all'utente