QUERY_USER_NOTIFICATION_STATE Enumeration (shellapi.h)

  • Artikel

Gibt den Zustand des Computers für den aktuellen Benutzer in Bezug auf die Bereitschaft zum Senden einer Benachrichtigung an. Wird von SHQueryUserNotificationState verwendet.

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;

Konstanten

 
QUNS_NOT_PRESENT
Wert: 1
Es wird ein Bildschirmschoner angezeigt, der Computer ist gesperrt, oder es wird eine nicht aktive Sitzung zum schnellen Benutzerwechsel ausgeführt.
QUNS_BUSY
Wert: 2
Eine Vollbildanwendung wird ausgeführt, oder es werden Präsentationseinstellungen angewendet. Mithilfe der Präsentationseinstellungen kann ein Benutzer seinen Computer mit einem einzigen Klick in einen Zustand versetzen, der für eine unterbrechungsfreie Präsentation geeignet ist, z. B. eine Reihe von PowerPoint-Folien.
QUNS_RUNNING_D3D_FULL_SCREEN
Wert: 3
Eine Direct3D-Anwendung im Vollbildmodus (exklusiver Modus) wird ausgeführt.
QUNS_PRESENTATION_MODE
Wert: 4
Der Benutzer hat die Windows-Präsentationseinstellungen aktiviert, um Benachrichtigungen und Popupnachrichten zu blockieren.
QUNS_ACCEPTS_NOTIFICATIONS
Wert: 5
Keiner der anderen Zustände ist gefunden, Benachrichtigungen können frei gesendet werden.
QUNS_QUIET_TIME
Wert: 6
In Windows 7 eingeführt. Der aktuelle Benutzer befindet sich in "stiller Zeit", also der ersten Stunde, nachdem sich ein neuer Benutzer zum ersten Mal bei seinem Konto angemeldet hat. Während dieser Zeit sollten die meisten Benachrichtigungen nicht gesendet oder angezeigt werden. Dies ermöglicht es einem Benutzer, sich ohne diese Ablenkungen an ein neues Computersystem zu gewöhnen. Die Ruhezeit tritt auch für jeden Benutzer nach einem Betriebssystemupgrade oder sauber Installation auf.



Anwendungen sollten das NIIF_RESPECT_QUIET_TIME-Flag in ihrer Benachrichtigungs- oder Ballon-QuickInfo festlegen, wodurch verhindert wird, dass diese Elemente angezeigt werden, während sich der aktuelle Benutzer im Ruhezustand befindet.

Beachten Sie, dass SHQueryUserNotificationState nur diesen Wert zurück QUNS_QUIET_TIME gibt, wenn sich der Benutzer in einem der anderen blockierten Modi (QUNS_NOT_PRESENT, QUNS_BUSY, QUNS_PRESENTATION_MODE oder QUNS_RUNNING_D3D_FULL_SCREEN) befindet.
QUNS_APP
Wert: 7
In Windows 8 eingeführt. Eine Windows Store-App wird ausgeführt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista, Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile shellapi.h