Função MessageBeep (winuser.h)
Toca um som de forma de onda. O som de forma de onda para cada tipo de som é identificado por uma entrada no Registro.
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. |
|
Consulte MB_ICONINFORMATION. |
|
Consulte MB_ICONWARNING. |
|
O som especificado como o som de Parada Crítica do Windows. |
|
Consulte MB_ICONERROR. |
|
O som especificado como o som do Asterisco do Windows. |
|
O som especificado como o som da Pergunta do Windows. |
|
Consulte MB_ICONERROR. |
|
O som especificado como o som exclamação do Windows. |
|
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) |