Partager via


Méthode IUserNotification ::P laySound (shobjidl_core.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 par pszSoundNamepqc 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 IUserNotification ::P laySound avec pszSoundNamepqc défini sur NULL.

L’événement sonore spécifié est généré à 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 à la lecture de 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, IUserNotification ::P laySound utilise le son par défaut du système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)