Funzione SHQueryUserNotificationState (shellapi.h)

Controlla lo stato del computer per l'utente corrente per determinare se inviare una notifica è appropriata.

Sintassi

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Parametri

[out] pquns

Tipo: QUERY_USER_NOTIFICATION_STATE*

Quando questa funzione restituisce, 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 .

Commenti

Le applicazioni devono chiamare SHQueryUserNotificationState e testare il valore restituito prima di visualizzare qualsiasi interfaccia utente di notifica simile alle notifiche a palloncini 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 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 sono presenti notifiche inviate 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	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-0 (introdotta in Windows 8.1)