Funzione SHQueryUserNotificationState (shellapi.h)

Controlla lo stato del computer per l'utente corrente per determinare se l'invio di una notifica è appropriato.

Sintassi

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parametri

[out] pquns

Tipo: QUERY_USER_NOTIFICATION_STATE*

Quando termina, questa funzione contiene un puntatore a uno dei valori dell'enumerazione QUERY_USER_NOTIFICATION_STATE .

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Osservazioni:

Le applicazioni devono chiamare SHQueryUserNotificationState e testare il valore restituito prima di visualizzare un'interfaccia utente di notifica simile alle notifiche balloon generate da Shell_NotifyIcon. Le notifiche devono essere visualizzate solo se questa API restituisce QNS_ACCEPTS_NOTIFICATIONS. In questo modo l'applicazione indica se l'utente esegue processi che non devono essere interrotti. Le finestre di primo livello ricevono un messaggio di WM_SETTINGCHANGE quando l'utente attiva o disattiva le impostazioni di presentazione e anche quando la sessione dell'utente è bloccata o sbloccata. Si noti che non vengono inviate notifiche all'avvio o all'arresto di un'applicazione a schermo intero.

Se questa funzione restituisce QUNS_QUIET_TIME, le notifiche devono essere visualizzate solo se critiche.

Requisiti

Requisito	Value
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Header	shellapi.h
Library	OneCore.Lib
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-0 (introdotto in Windows 8.1)