IUserNotification::P laySound-Methode (shobjidl_core.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 pszSoundNamepqc 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 IUserNotification::P laySound auf, wobei pszSoundNamepqc 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 IUserNotification::P laySound den Standardsound des Systems.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)