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 .

Valor de retorno

Tipo: HRESULT

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

Observações

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 de 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 está 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.

Requirements