Función SHQueryUserNotificationState (shellapi.h)

Comprueba el estado del equipo para que el usuario actual determine si el envío de una notificación es adecuado.

Syntax

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parámetros

[out] pquns

Tipo: QUERY_USER_NOTIFICATION_STATE*

Cuando se devuelve esta función, contiene un puntero a uno de los valores de la enumeración QUERY_USER_NOTIFICATION_STATE .

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Observaciones

Las aplicaciones deben llamar a SHQueryUserNotificationState y probar el valor devuelto antes de mostrar cualquier interfaz de usuario de notificación similar a las notificaciones de globo generadas por Shell_NotifyIcon. Las notificaciones solo se deben mostrar si esta API devuelve QNS_ACCEPTS_NOTIFICATIONS. Esto informa a la aplicación si el usuario está ejecutando procesos que no deben interrumpirse. Las ventanas de nivel superior reciben un mensaje de WM_SETTINGCHANGE cuando el usuario activa o desactiva la configuración de presentación, y también cuando la sesión del usuario está bloqueada o desbloqueada. Tenga en cuenta que no se envían notificaciones cuando el usuario inicia o detiene una aplicación de pantalla completa.

Si esta función devuelve QUNS_QUIET_TIME, las notificaciones solo se deben mostrar si son críticas.

Requisitos