术语 | shqueryusernotificationstate |
释义 | SHQueryUserNotificationState 语法: HRESULT SHQueryUserNotificationState( QUERY_USER_NOTIFICATION_STATE *pquns ); SHQueryUserNotificationState功能 将检查当前用户计算机状态,以确定是否发送通知是适当的。 参数 pquns [内]当此函数返回时,它包含一个指向对QUERY_USER_NOTIFICATION_STATE枚举值之一。 返回值 返回S_OK如果成功,或其他错误值。 备注 应用程序应该调用SHQueryUserNotificationState和测试显示任何通知之前,用户界面(UI),它类似于气球由Shell_NotifyIcon函数产生通知的返回值。通知只应显示如果这个API返回QNS_ACCEPTS_NOTIFICATIONS。此通知应用程序用户是否正在运行,不应该中断进程。顶层窗口收到WM_SETTINGCHANGE消息当用户打开或关闭演示设置,并在用户的会话被锁定或解锁。请注意有没有发送通知,当用户启动或停止全屏幕的应用程序。 如果这个函数返回QUNS_QUIET_TIME,通知应只显示,如果关键。 功能信息 最低DLL版本 Shell32.dll 自定义ImplementationNo Headershellapi.h import libraryNone 最低支持操作系统 Vista ==英文原文==SHQueryUserNotificationState Function Checks the state of the computer for the current user to determine whether sending a notification is appropriate. Syntax HRESULT SHQueryUserNotificationState( QUERY_USER_NOTIFICATION_STATE *pquns ); Parameters pquns [out] When this function returns, contains a pointer to one of the values of the QUERY_USER_NOTIFICATION_STATE enumeration. Return Value Returns S_OK if successful, or an error value otherwise. Remarks Applications should call SHQueryUserNotificationState and test the return value before displaying any notification user interface (UI) that is similar to the balloon notifications generated by Shell_NotifyIcon . Notifications should only be displayed if this API returns QNS_ACCEPTS_NOTIFICATIONS. This informs the application whether the user is running processes that should not be interrupted. Top-level windows receive a WM_SETTINGCHANGE message when the user turns presentation settings on or off, and also when the user's session is locked or unlocked. Note that there are no notifications sent when the user starts or stops a full-screen application. If this function returns QUNS_QUIET_TIME , notifications should be displayed only if critical. Function Information Minimum DLL VersionShell32.dll Custom ImplementationNo Headershellapi.h Import libraryNone Minimum operating systemsWindows Vista ==原始网址==http://msdn.microsoft.com/en-us/library/bb762242(VS.85).aspx\n |
随便看 |
|
windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。