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 集 在 Windows 8.1) 中引入的 ext-ms-win-shell-shell32-l1-2-0 (