SHQueryUserNotificationState-Funktion (shellapi.h)

Überprüft den Status des Computers für den aktuellen Benutzer, um festzustellen, ob das Senden einer Benachrichtigung geeignet ist.

Syntax

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Die Parameter

[out] pquns

Typ: QUERY_USER_NOTIFICATION_STATE*

Wenn diese Funktion zurückgegeben wird, enthält sie einen Zeiger auf einen der Werte der QUERY_USER_NOTIFICATION_STATE Enumeration.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Anwendungen sollten SHQueryUserNotificationState aufrufen und den Rückgabewert testen, bevor eine Benachrichtigungsbenutzeroberfläche angezeigt wird, die den von Shell_NotifyIcon generierten Sprechblasenbenachrichtigungen ähnelt. Benachrichtigungen sollten nur angezeigt werden, wenn diese API QNS_ACCEPTS_NOTIFICATIONS zurückgibt. Dadurch wird die Anwendung darüber informiert, ob der Benutzer Prozesse ausführt, die nicht unterbrochen werden sollen. Fenster auf oberster Ebene erhalten eine WM_SETTINGCHANGE Meldung, wenn der Benutzer die Präsentationseinstellungen ein- oder ausschaltet und auch wenn die Sitzung des Benutzers gesperrt oder entsperrt ist. Beachten Sie, dass beim Starten oder Beenden einer Vollbildanwendung keine Benachrichtigungen gesendet werden.

Wenn diese Funktion QUNS_QUIET_TIME zurückgibt, sollten Benachrichtigungen nur angezeigt werden, wenn sie kritisch sind.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform	Fenster
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
API-Satz	ext-ms-win-shell-shell32-l1-2-0 (eingeführt in Windows 8.1)