Fungsi SHQueryUserNotificationState (shellapi.h)

Memeriksa status komputer untuk pengguna saat ini untuk menentukan apakah mengirim pemberitahuan sudah sesuai.

Syntax

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parameter-parameternya

[out] pquns

Jenis: QUERY_USER_NOTIFICATION_STATE*

Saat fungsi ini kembali, berisi penunjuk ke salah satu nilai enumerasi QUERY_USER_NOTIFICATION_STATE .

Mengembalikan nilai

Jenis: HRESULT

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

Komentar

Aplikasi harus memanggil SHQueryUserNotificationState dan menguji nilai pengembalian sebelum menampilkan antarmuka pengguna pemberitahuan yang mirip dengan pemberitahuan balon yang dihasilkan oleh Shell_NotifyIcon. Pemberitahuan hanya boleh ditampilkan jika API ini mengembalikan QNS_ACCEPTS_NOTIFICATIONS. Ini menginformasikan aplikasi apakah pengguna menjalankan proses yang seharusnya tidak terganggu. Jendela tingkat atas menerima pesan WM_SETTINGCHANGE saat pengguna mengaktifkan atau menonaktifkan pengaturan presentasi, dan juga saat sesi pengguna dikunci atau dibuka kuncinya. Perhatikan bahwa tidak ada pemberitahuan yang dikirim saat pengguna memulai atau menghentikan aplikasi layar penuh.

Jika fungsi ini mengembalikan QUNS_QUIET_TIME, pemberitahuan harus ditampilkan hanya jika penting.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-0 (diperkenalkan di Windows 8.1)