QUERY_USER_NOTIFICATION_STATE enumeration (shellapi.h)

  • Article

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

Syntax

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
Value: 1
A screen saver is displayed, the machine is locked, or a nonactive Fast User Switching session is in progress.
QUNS_BUSY
Value: 2
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
Value: 3
A full-screen (exclusive mode) Direct3D application is running.
QUNS_PRESENTATION_MODE
Value: 4
The user has activated Windows presentation settings to block notifications and pop-up messages.
QUNS_ACCEPTS_NOTIFICATIONS
Value: 5
None of the other states are found, notifications can be freely sent.
QUNS_QUIET_TIME
Value: 6
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
Value: 7
Introduced in Windows 8. A Windows Store app is running.

Requirements

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