Compartir a través de

Función MessageBeep (winuser.h)

  • Artículo

Reproduce un sonido de forma de onda. El sonido de forma de onda para cada tipo de sonido se identifica mediante una entrada en el registro.

 
Nota en Windows Server 2022, la tarea Microsoft\Windows\Multimedia\SystemSoundsService del Programador de tareas está deshabilitada. Esta tarea deberá habilitarse para que MessageBeep funcione.

Sintaxis

BOOL MessageBeep(
  [in] UINT uType
);

Parámetros

[in] uType

El sonido que se va a reproducir. El usuario establece los sonidos a través de la aplicación panel de control de sonido y, a continuación, se almacena en el registro.

Este parámetro puede ser uno de los siguientes valores.

Valor Significado
0xFFFFFFFF Un simple pitido. Si la tarjeta de sonido no está disponible, el sonido se genera mediante el altavoz.
MB_ICONASTERISK
0x00000040L
 Consulte MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 Consulte MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 El sonido especificado como el sonido Detención crítica de Windows.
MB_ICONHAND
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 El sonido especificado como sonido de Windows Asterisco.
MB_ICONQUESTION
0x00000020L
 El sonido especificado como sonido de pregunta de Windows.
MB_ICONSTOP
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 El sonido especificado como el sonido de exclamación de Windows.
MB_OK
0x00000000L
 El sonido especificado como sonido De pitido predeterminado de Windows.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Después de poner en cola el sonido, la función MessageBeep devuelve el control a la función de llamada y reproduce el sonido de forma asincrónica.

Si no puede reproducir el sonido de alerta especificado, MessageBeep intenta reproducir el sonido predeterminado del sistema. Si no puede reproducir el sonido predeterminado del sistema, la función genera un sonido de pitido estándar mediante la función Beep. A partir de Windows 7, esto reproduce un tono simple en el dispositivo de sonido predeterminado. Consulte la documentación de la función Beep para obtener más información.

El usuario puede deshabilitar el pitido de advertencia mediante la aplicación Panel de control de sonido.

Nota Para enviar un pitido a un cliente remoto, use la función Beep. La función Beep se redirige al cliente, mientras que MessageBeep no.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winuser.h (incluya Windows.h)
biblioteca de User32.lib
DLL de User32.dll
conjunto de API de ext-ms-win-ntuser-misc-l1-1-0 (introducido en Windows 8)

Consulte también

de pitido

funciones de control de errores

FlashWindow

notificar al usuario