Método IUserNotification2::P laySound (shobjidl.h)
Reproduce un sonido junto con la notificación.
Sintaxis
HRESULT PlaySound(
[in] LPCWSTR pszSoundName
);
Parámetros
[in] pszSoundName
Tipo: LPCWSTR
Puntero a una cadena Unicode terminada en null que especifica el alias del archivo de sonido que se va a reproducir.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
La cadena a la que apunta pszSoundName contiene un alias para un evento del sistema que se encuentra en el registro o en el archivo Win.ini; por ejemplo, "SystemExit".
El sonido especificado se reproduce de forma asincrónica y el método devuelve inmediatamente después de comenzar el sonido. Para detener un sonido asincrónico de forma de onda, llame a IUserNotification2::P laySoundSound con pszSoundName establecido en NULL.
El evento de sonido especificado dará lugar a otro evento de sonido que ya se está reproduciendo. Si no se puede reproducir un sonido porque el recurso necesario para reproducir ese sonido está ocupado, el método devuelve inmediatamente S_FALSE sin reproducir el sonido solicitado.
Si no se encuentra el sonido especificado, IUserNotification2::P laySound usa el sonido predeterminado del sistema.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl.h |