Função SHQueryUserNotificationState (shellapi.h)

Verifica o estado do computador para que o usuário atual determine se o envio de uma notificação é apropriado.

Sintaxe

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parâmetros

[out] pquns

Tipo: QUERY_USER_NOTIFICATION_STATE*

Quando essa função retorna, contém um ponteiro para um dos valores da enumeração QUERY_USER_NOTIFICATION_STATE .

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os aplicativos devem chamar SHQueryUserNotificationState e testar o valor retornado antes de exibir qualquer interface do usuário de notificação semelhante às notificações de balão geradas por Shell_NotifyIcon. As notificações só deverão ser exibidas se essa API retornar QNS_ACCEPTS_NOTIFICATIONS. Isso informa ao aplicativo se o usuário está executando processos que não devem ser interrompidos. As janelas de nível superior recebem uma mensagem WM_SETTINGCHANGE quando o usuário ativa ou desativa as configurações da apresentação e também quando a sessão do usuário é bloqueada ou desbloqueada. Observe que não há notificações enviadas quando o usuário inicia ou interrompe um aplicativo de tela inteira.

Se essa função retornar QUNS_QUIET_TIME, as notificações só deverão ser exibidas se forem críticas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shellapi.h
DLL	Shell32.dll
Conjunto de APIs	ext-ms-win-shell-shell32-l1-2-0 (introduzido no Windows 8.1)