IUserNotification2 ::P laySound, méthode (shobjidl.h)

Lit un son conjointement avec la notification.

Syntaxe

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

Paramètres

[in] pszSoundName

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie l’alias du fichier audio à lire.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La chaîne pointée vers pszSoundName contient un alias pour un événement système trouvé dans le registre ou le fichier Win.ini ; pour instance, « SystemExit ».

Le son spécifié est lu de manière asynchrone et la méthode retourne immédiatement après le début du son. Pour arrêter un son de forme d’onde asynchrone, appelez IUserNotification2 ::P laySound avec pszSoundName défini sur NULL.

L’événement sonore spécifié cédera à un autre événement sonore qui est déjà en cours de lecture. Si un son ne peut pas être lu parce que la ressource nécessaire pour lire ce son est occupée, la méthode retourne immédiatement S_FALSE sans lire le son demandé.

Si le son spécifié est introuvable, IUserNotification2 ::P laySound utilise le son par défaut du système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl.h

Voir aussi

IUserNotification2

PlaySound