SHQueryUserNotificationState 函数 (shellapi.h)

检查计算机的当前用户的状态,以确定发送通知是否合适。

Syntax

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 [仅限桌面应用]
目标平台 Windows操作系统
Header shellapi.h
Library OneCore.Lib
DLL Shell32.dll
API 集 ext-ms-win-shell-shell32-l1-2-0(在 Windows 8.1 中引入)