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