QueryUserNotificationState Enumeration

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

Used by SHQueryUserNotificationState(QueryUserNotificationState) function.

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
C#Request Example
public enum QueryUserNotificationState

Remarks

Members

NotPresent 1 A screen saver is displayed, the machine is locked, or a non-active Fast User Switching session is in progress.
Busy 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.

RunningD3DFullScreen 3 A full-screen (exclusive mode) Direct-3D application is running.
PresentationMode 4 The user has activated Windows presentation settings to block notifications and pop-up messages.
AcceptsNotifications 5 None of the other states are found, notifications can be freely sent.
QuietTime 6 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 (NotPresent, Busy, PresentationMode, or RunningD3DFullScreen) SHQueryUserNotificationState(QueryUserNotificationState) returns only that value, and does not report QuietTime.

App 7 A Windows Store app is running.

See Also