Функция 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. Уведомления должны отображаться только в том случае, если этот API возвращает QNS_ACCEPTS_NOTIFICATIONS. Это сообщает приложению, выполняет ли пользователь процессы, которые не должны быть прерваны. Окна верхнего уровня получают сообщение WM_SETTINGCHANGE при включении или отключении параметров презентации, а также при блокировке или разблокировке сеанса пользователя. Обратите внимание, что при запуске или остановке полноэкранного приложения уведомления не отправляются.

Если эта функция возвращает QUNS_QUIET_TIME, уведомления должны отображаться только в случае критического значения.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	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)