Поделиться через


Функция 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 [только классические приложения]
Целевая платформа Windows
Header shellapi.h
DLL Shell32.dll
Набор API ext-ms-win-shell-shell32-l1-2-0 (представлено в Windows 8.1)