SHQueryUserNotificationState 函式 (shellapi.h)

  • 發行項

檢查計算機目前用戶的狀態，以判斷傳送通知是否適當。

語法

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

參數

[out] pquns

類型： QUERY_USER_NOTIFICATION_STATE*

當此函式傳回時，會包含其中一個 QUERY_USER_NOTIFICATION_STATE 列舉值的指標。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

應用程式應該呼叫 SHQueryUserNotificationState 並測試傳回值，再顯示與 Shell_NotifyIcon所產生的批注通知類似的任何通知 UI。 只有在此 API 傳回 QNS_ACCEPTS_NOTIFICATIONS時，才會顯示通知。 這會通知應用程式使用者是否正在執行不應中斷的進程。 最上層視窗會在用戶開啟或關閉簡報設定時，以及鎖定或解除鎖定使用者的會話時收到 WM_SETTINGCHANGE 訊息。 請注意，當用戶啟動或停止全螢幕應用程式時，不會傳送任何通知。

如果此函式傳回 QUNS_QUIET_TIME，則只有在重大時才會顯示通知。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shellapi.h
Dll Shell32.dll
API 集合 ext-ms-win-shell-shell32-l1-2-0 (在 Windows 8.1) 中引進