Fonction SHQueryUserNotificationState (shellapi.h)

  • Article

Vérifie l’état de l’ordinateur pour l’utilisateur actuel afin de déterminer si l’envoi d’une notification est approprié.

Syntaxe

SHSTDAPI SHQueryUserNotificationState(
  [out] QUERY_USER_NOTIFICATION_STATE *pquns
);

Paramètres

[out] pquns

Type : QUERY_USER_NOTIFICATION_STATE*

Lorsque cette fonction est retournée, contient un pointeur vers l’une des valeurs de l’énumération QUERY_USER_NOTIFICATION_STATE .

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les applications doivent appeler SHQueryUserNotificationState et tester la valeur de retour avant d’afficher une interface utilisateur de notification similaire aux notifications de bulle générées par Shell_NotifyIcon. Les notifications ne doivent être affichées que si cette API retourne QNS_ACCEPTS_NOTIFICATIONS. Cela indique à l’application si l’utilisateur exécute des processus qui ne doivent pas être interrompus. Les fenêtres de niveau supérieur reçoivent un message WM_SETTINGCHANGE lorsque l’utilisateur active ou désactive les paramètres de présentation, ainsi que lorsque la session de l’utilisateur est verrouillée ou déverrouillée. Notez qu’aucune notification n’est envoyée lorsque l’utilisateur démarre ou arrête une application en plein écran.

Si cette fonction retourne QUNS_QUIET_TIME, les notifications doivent être affichées uniquement si elles sont critiques.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shellapi.h
DLL Shell32.dll
Ensemble d’API ext-ms-win-shell-shell32-l1-2-0 (introduit dans Windows 8.1)