Compartir a través de

Función SHQueryUserNotificationState (shellapi.h)

  • Artículo

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

Sintaxis

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parámetros

[out] pquns

Tipo: QUERY_USER_NOTIFICATION_STATE*

Cuando esta función devuelve, 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 realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

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 deben mostrarse si esta API devuelve QNS_ACCEPTS_NOTIFICATIONS. Esto informa a la aplicación de 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 deben mostrarse si son críticas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shellapi.h
Archivo DLL Shell32.dll
Conjunto de API ext-ms-win-shell-shell32-l1-2-0 (introducido en Windows 8.1)