This topic has not yet been rated - Rate this topic

QUERY_USER_NOTIFICATION_STATE enumeration

Specifies the state of the machine for the current user in relation to the propriety of sending a notification. Used by SHQueryUserNotificationState.

Syntax

C++


typedef enum  { 
  QUNS_NOT_PRESENT              = 1,
  QUNS_BUSY                     = 2,
  QUNS_RUNNING_D3D_FULL_SCREEN  = 3,
  QUNS_PRESENTATION_MODE        = 4,
  QUNS_ACCEPTS_NOTIFICATIONS    = 5,
  QUNS_QUIET_TIME               = 6,
  QUNS_APP                      = 7
} QUERY_USER_NOTIFICATION_STATE;

Constants

QUNS_NOT_PRESENT

A screen saver is displayed, the machine is locked, or a nonactive Fast User Switching session is in progress.

QUNS_BUSY

A full-screen application is running or Presentation Settings are applied. Presentation Settings allow a user to put their machine into a state fit for an uninterrupted presentation, such as a set of PowerPoint slides, with a single click.

QUNS_RUNNING_D3D_FULL_SCREEN

A full-screen (exclusive mode) Direct3D application is running.

QUNS_PRESENTATION_MODE

The user has activated Windows presentation settings to block notifications and pop-up messages.

QUNS_ACCEPTS_NOTIFICATIONS

None of the other states are found, notifications can be freely sent.

QUNS_QUIET_TIME

Introduced in Windows 7. The current user is in "quiet time", which is the first hour after a new user logs into his or her account for the first time. During this time, most notifications should not be sent or shown. This lets a user become accustomed to a new computer system without those distractions. Quiet time also occurs for each user after an operating system upgrade or clean installation.

Applications should set the NIIF_RESPECT_QUIET_TIME flag in their notifications or balloon tooltip, which prevents those items from being displayed while the current user is in the quiet-time state.

Note that during quiet time, if the user is in one of the other blocked modes (QUNS_NOT_PRESENT, QUNS_BUSY, QUNS_PRESENTATION_MODE, or QUNS_RUNNING_D3D_FULL_SCREEN) SHQueryUserNotificationState returns only that value, and does not report QUNS_QUIET_TIME.

QUNS_APP

Introduced in Windows 8. A Windows Store app is running.

Requirements

Minimum supported client	Windows Vista, Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	Shellapi.h

Send comments about this topic to Microsoft

Build date: 11/28/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD