檢查目前使用者的電腦狀態，以判斷傳送通知是否適當。
語法
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，則只有在重要時才應顯示通知。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| Header | shellapi.h |
| Library | OneCore.Lib |
| DLL | Shell32.dll |
| API 集 | ext-ms-win-shell-shell32-l1-2-0 （Windows 8.1 中引進） |