WM_CANCELJOURNAL Nachricht

Warnung

Journaling Hooks-APIs werden ab Windows 11 nicht mehr unterstützt und werden in einer zukünftigen Version entfernt. Daher wird dringend empfohlen, stattdessen die SendInput TextInput-API aufzurufen.

Wird an eine Anwendung gesendet, wenn ein Benutzer die Journalaktivitäten der Anwendung abbricht. Die Nachricht wird mit einem NULL-Fensterhandle bereitgestellt.

#define WM_CANCELJOURNAL                0x004B

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Typ: void

Diese Meldung gibt keinen Wert zurück. Sie soll aus der Standard-Schleife einer Anwendung oder einer GetMessage-Hookprozedur und nicht aus einer Fensterprozedur verarbeitet werden.

Hinweise

Journaldatensatz- und Wiedergabemodi sind Modi, die dem System auferlegt werden und es einer Anwendung ermöglichen, Benutzereingaben sequenziell aufzuzeichnen oder wiederzugeben. Das System wechselt in diese Modi, wenn eine Anwendung eine JournalRecordProc - oder JournalPlaybackProc-Hookprozedur installiert. Wenn sich das System in einem dieser Journalmodi befindet, müssen Anwendungen abwechselnd Eingaben aus der Eingabewarteschlange lesen. Wenn eine Anwendung die Eingabe nicht mehr liest, während sich das System in einem Journalmodus befindet, müssen andere Anwendungen warten.

Um ein robustes System zu gewährleisten, das von keiner Anwendung nicht reagiert werden kann, bricht das System automatisch alle Journalaktivitäten ab, wenn ein Benutzer STRG+ESC oder STRG+ALT+ENTF drückt. Das System hebt dann alle Journaling-Hookprozeduren auf und sendet eine WM_CANCELJOURNAL Nachricht mit einem NULL-Fensterhandle an die Anwendung, die den Journalinghook festgelegt hat.

Die WM_CANCELJOURNAL Nachricht verfügt über ein NULL-Fensterhandle , daher kann sie nicht an eine Fensterprozedur gesendet werden. Es gibt zwei Möglichkeiten für eine Anwendung, eine WM_CANCELJOURNAL Nachricht anzuzeigen: Wenn die Anwendung in einer eigenen Standard-Schleife ausgeführt wird, muss sie die Nachricht zwischen dem Aufruf von GetMessage oder PeekMessage und dem Aufruf von DispatchMessage abfangen. Wenn die Anwendung nicht in einer eigenen Standard-Schleife ausgeführt wird, muss sie eine GetMsgProc-Hookprozedur festlegen (über einen Aufruf von SetWindowsHookEx, der den WH_GETMESSAGE Hooktyp angibt), die auf die Nachricht überwacht.

Wenn einer Anwendung eine WM_CANCELJOURNAL-Nachricht angezeigt wird, kann sie zwei Dinge annehmen: Der Benutzer hat den Journaldatensatz oder den Wiedergabemodus absichtlich abgebrochen, und das System hat bereits alle Journaldatensätze oder Wiedergabehookprozeduren enthookt.

Beachten Sie, dass die oben genannten Tastenkombinationen (STRG+ESC oder STRG+ALT+ENTF) dazu führen, dass das System das Journaling abbricht. Wenn eine Anwendung nicht mehr reagiert, gibt sie dem Benutzer ein Mittel zur Wiederherstellung. Der VK_CANCEL virtuellen Schlüsselcode (in der Regel als Tastenkombination STRG+BREAK implementiert) sollte eine Anwendung, die sich im Journaldatensatzmodus befindet, als Signal watch, dass der Benutzer die Journalaktivität abbrechen möchte. Der Unterschied besteht darin, dass die Überwachung auf VK_CANCEL ein empfohlenes Verhalten für Journalanwendungen ist, während STRG+ESC oder STRG+ALT+ENTF dazu führen, dass das System das Journaling unabhängig vom Verhalten einer Journalanwendung abbricht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

JournalPlaybackProc

JournalRecordProc

GetMsgProc

SetWindowsHookEx

Konzept

Hooks