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.

 
Nota No Windows Server 2022, a tarefa Microsoft\Windows\Multimídia\SystemSoundsService no Agendador de Tarefas está desabilitada. Essa tarefa precisará ser habilitada para que 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 Som e armazenados no registro.

Esse parâmetro pode usar 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 Asterisco do Windows.
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 exclamação do Windows.
MB_OK
0x000000000L
 O som especificado como o som de Bipe Padrão do Windows.

Valor retornado

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

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

Comentários

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 tentará 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 por meio do alto-falante do computador.

O usuário pode desabilitar o bipe de aviso usando o aplicativo painel de controle Som.

Nota 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

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-misc-l1-1-0 (introduzido em Windows 8)

Confira também

Beep

Funções de tratamento de erro

FlashWindow

Notificar o usuário