IUserNotification2::P laySound-Methode (shobjidl.h)

Gibt einen Sound in Verbindung mit der Benachrichtigung wieder.

Syntax

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

Parameter

[in] pszSoundName

Typ: LPCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Alias der wiederzugebenden Audiodatei angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Zeichenfolge, auf die von pszSoundName verwiesen wird, enthält einen Alias für ein Systemereignis, das in der Registrierung oder in der Win.ini-Datei gefunden wird. für instance "SystemExit".

Der angegebene Sound wird asynchron wiedergegeben, und die Methode gibt unmittelbar nach dem Starten des Sounds zurück. Um einen asynchronen Wellenformsound zu beenden, rufen Sie IUserNotification2::P laySound auf , wobei pszSoundName auf NULL festgelegt ist.

Das angegebene Soundereignis ergibt ein anderes Soundereignis, das bereits wiedergegeben wird. Wenn ein Sound nicht wiedergegeben werden kann, weil die für die Wiedergabe dieses Sounds erforderliche Ressource ausgelastet ist, gibt die Methode sofort S_FALSE zurück, ohne den angeforderten Sound wiederzugeben.

Wenn der angegebene Sound nicht gefunden werden kann, verwendet IUserNotification2::P laySound den Standardsound des Systems.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl.h

Weitere Informationen

IUserNotification2

PlaySound