SHQueryUserNotificationState, fonction (shellapi.h)

Vérifie l’état de l’ordinateur pour que l’utilisateur actuel détermine 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 toute 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 informe 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 critiques.

Spécifications