SHQueryUserNotificationState-Funktion (shellapi.h)

Überprüft den Zustand des Computers für den aktuellen Benutzer, um zu bestimmen, ob das Senden einer Benachrichtigung angemessen ist.

Syntax

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parameter

[out] pquns

Typ: QUERY_USER_NOTIFICATION_STATE*

Wenn diese Funktion zurückgibt, enthält 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 Fehlercode HRESULT zurückgegeben.

Hinweise

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 informiert, ob der Benutzer Prozesse ausführt, die nicht unterbrochen werden sollen. Fenster der obersten Ebene erhalten eine WM_SETTINGCHANGE Meldung, wenn der Benutzer die Präsentationseinstellungen ein- oder ausschaltet und wenn die Sitzung des Benutzers gesperrt oder entsperrt ist. Beachten Sie, dass keine Benachrichtigungen gesendet werden, wenn der Benutzer eine Vollbildanwendung startet oder beendet.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
DLL	Shell32.dll
APIs	ext-ms-win-shell-shell32-l1-2-0 (eingeführt in Windows 8.1)