Metodo IUserNotification::P laySound (shobjidl_core.h)

Riproduce un suono in combinazione con la notifica.

Sintassi

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

Parametri

[in] pszSoundName

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null che specifica l'alias del file audio da riprodurre.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La stringa a cui punta pszSoundNamepqc contiene un alias per un evento di sistema trovato nel Registro di sistema o nel file Win.ini; ad esempio "SystemExit".

Il suono specificato viene riprodotto in modo asincrono e il metodo viene restituito immediatamente dopo l'inizio del suono. Per arrestare un suono a forma d'onda asincrona, chiama IUserNotification::P laySound con pszSoundNamepqc impostato su NULL.

L'evento audio specificato restituirà un altro evento sonoro già in riproduzione. Se non è possibile riprodurre un suono perché la risorsa necessaria per riprodurre tale suono è occupata, il metodo restituisce immediatamente S_FALSE senza riprodurre il suono richiesto.

Se non è possibile trovare il suono specificato, IUserNotification::P laySound usa il suono predefinito del sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)