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
);

Parameter

[out] pquns

Typ: QUERY_USER_NOTIFICATION_STATE*

Wenn diese Funktion zurückgegeben wird, 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 HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Anwendungen sollten SHQueryUserNotificationState aufrufen und den Rückgabewert testen, bevor eine Benachrichtigungsbenutzeroberfläche angezeigt wird, die mit den von Shell_NotifyIcon generierten Sprechblasenbenachrichtigungen vergleichbar ist. 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 auf oberster Ebene erhalten eine WM_SETTINGCHANGE Meldung, wenn der Benutzer die Präsentationseinstellungen aktiviert oder deaktiviert, und auch wenn die Sitzung des Benutzers gesperrt oder entsperrt ist. Beachten Sie, dass beim Starten oder Anhalten einer Vollbildanwendung keine Benachrichtigungen gesendet werden.

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

Anforderungen

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)