Compartilhar via

Função MessageBeep (winuser.h)

  • Artigo

Toca um som de forma de onda. O som de forma de onda para cada tipo de som é identificado por uma entrada no Registro.

 
Observação no Windows Server 2022, a tarefa Microsoft\Windows\Multimedia\SystemSoundsService no Agendador de Tarefas está desabilitada. Essa tarefa precisará ser habilitada para que o MessageBeep funcione.

Sintaxe

BOOL MessageBeep(
  [in] UINT uType
);

Parâmetros

[in] uType

O som a ser tocado. Os sons são definidos pelo usuário por meio do aplicativo do painel de controle De som e armazenados no registro.

Esse parâmetro pode ser um dos valores a seguir.

Valor Significado
0xFFFFFFFF Um bipe simples. Se a placa de som não estiver disponível, o som será gerado usando o alto-falante.
MB_ICONASTERISK
0x00000040L
 Consulte MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 Consulte MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 O som especificado como o som de Parada Crítica do Windows.
MB_ICONHAND
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 O som especificado como o som do Windows Asterisk.
MB_ICONQUESTION
0x00000020L
 O som especificado como o som da Pergunta do Windows.
MB_ICONSTOP
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 O som especificado como o som de Exclamação do Windows.
MB_OK
0x00000000L
 O som especificado como o som de bipe padrão do Windows.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Depois de enfileirar o som, a função MessageBeep retorna o controle para a função de chamada e reproduz o som de forma assíncrona.

Se ele não puder reproduzir o som de alerta especificado, MessageBeep tenta reproduzir o som padrão do sistema. Se ele não puder reproduzir o som padrão do sistema, a função produzirá um som de bipe padrão usando a função Beep. A partir do Windows 7, isso reproduz um tom simples no dispositivo de som padrão. Consulte a documentação da função Beep para obter mais detalhes.

O usuário pode desabilitar o bipe de aviso usando o aplicativo do painel de controle De som.

Observação Para enviar um bipe para um cliente remoto, use a função Beep. A função Beep é redirecionada para o cliente, enquanto MessageBeep não é.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winuser.h (inclua Windows.h)
biblioteca User32.lib
de DLL User32.dll
conjunto de API ext-ms-win-ntuser-misc-l1-1-0 (introduzido no Windows 8)

Consulte também

de bipe

Funções de tratamento de erros

FlashWindow

Notificando o usuário