Metode IUserNotification::P laySound (shobjidl_core.h)

Memutar suara bersama dengan pemberitahuan.

Sintaks

HRESULT PlaySound(
  [in] LPCWSTR pszSoundName
);

Parameter

[in] pszSoundName

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang menentukan alias file suara untuk diputar.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

String yang ditunjukkan oleh pszSoundNamepqc berisi alias untuk peristiwa sistem yang ditemukan di registri atau file Win.ini; misalnya, "SystemExit".

Suara yang ditentukan diputar secara asinkron dan metode kembali segera setelah memulai suara. Untuk menghentikan suara bentuk gelombang asinkron, panggil IUserNotification::P laySound dengan pszSoundNamepqc diatur ke NULL.

Peristiwa suara yang ditentukan akan menghasilkan peristiwa suara lain yang sudah diputar. Jika suara tidak dapat diputar karena sumber daya yang diperlukan untuk memutar suara tersebut sibuk, metode segera mengembalikan S_FALSE tanpa memutar suara yang diminta.

Jika suara yang ditentukan tidak dapat ditemukan, IUserNotification::P laySound menggunakan suara default sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)