Share via

Método IUserNotification::P laySound (shobjidl_core.h)

  • Artículo

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 pszSoundNamepqc 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 IUserNotification::P laySound con pszSoundNamepqc establecido en NULL.

El evento de sonido especificado dará lugar a otro evento de sonido que ya 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, IUserNotification::P laySound usa el sonido predeterminado del sistema.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)