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 |