message WM_CANCELJOURNAL

Publié dans une application lorsqu’un utilisateur annule les activités de journalisation de l’application. Le message est publié avec un handle de fenêtre NULL.

#define WM_CANCELJOURNAL                0x004B

Paramètres

wParam

Ce paramètre n’est pas utilisé.

lParam

Ce paramètre n’est pas utilisé.

Valeur de retour

Type : void

Ce message ne retourne pas de valeur. Il est destiné à être traité à partir de la boucle principale d’une application ou d’une procédure de hook GetMessage, et non à partir d’une procédure de fenêtre.

Remarques

Les modes d’enregistrement et de lecture des journaux sont des modes imposés au système qui permettent à une application d’enregistrer ou de lire l’entrée utilisateur de manière séquentielle. Le système entre dans ces modes lorsqu’une application installe une procédure de raccordement JournalRecordPro c ou JournalPlaybackProc. Lorsque le système se trouve dans l’un de ces modes de journalisation, les applications doivent prendre des tours en lisant les entrées à partir de la file d’attente d’entrée. Si une application cesse de lire l’entrée pendant que le système est en mode journalisation, d’autres applications sont forcées d’attendre.

Pour garantir un système robuste, celui qui ne peut pas être rendu sans réponse par une application, le système annule automatiquement toutes les activités de journalisation lorsqu’un utilisateur appuie sur Ctrl+Échap ou Ctrl+Alt+DEL. Le système déshooke ensuite toutes les procédures de raccordement de journalisation et publie un message WM_CANCELJOURNAL, avec un handle de fenêtre NULL, à l’application qui définit le hook de journalisation.

Le message WM_CANCELJOURNAL a un handle de fenêtre NULL, par conséquent, il ne peut pas être distribué à une procédure de fenêtre. Il existe deux façons pour une application de voir un message WM_CANCELJOURNAL : si l’application s’exécute dans sa propre boucle principale, elle doit intercepter le message entre son appel à GetMessage ou PeekMessage et son appel à DispatchMessage. Si l’application n’est pas en cours d’exécution dans sa propre boucle principale, elle doit définir une procédure de hookGetMsgProc (via un appel à SetWindowsHookEx en spécifiant le type de hook WH_GETMESSAGE) qui surveille le message.

Lorsqu’une application voit un message WM_CANCELJOURNAL, il peut supposer deux choses : l’utilisateur a annulé intentionnellement l’enregistrement de journal ou le mode de lecture, et le système a déjà décoché tous les enregistrements de journal ou procédures de raccordement de lecture.

Notez que les combinaisons de touches mentionnées ci-dessus (Ctrl+Échap ou Ctrl+Alt+Del) entraînent l’annulation de la journalisation par le système. Si une application n’est pas réponsive, elle permet à l’utilisateur d’avoir un moyen de récupération. Le code de clé virtuelle VK_CANCEL (généralement implémenté comme combinaison de touches CTRL+BREAK) est ce qu’une application en mode enregistrement journal doit surveiller comme signal que l’utilisateur souhaite annuler l’activité de journalisation. La différence est que la surveillance de VK_CANCEL est un comportement suggéré pour les applications de journalisation, tandis que Ctrl+Échap ou Ctrl+Alt+Del entraîne l’annulation du journalisation par le système, quel que soit le comportement d’une application de journalisation.

Spécifications

Voir aussi

: référence

JournalPlaybackProc

journalRecordProc

GetMsgProc

SetWindowsHookEx

Conceptuel

hooks