komunikat WM_CANCELJOURNAL

Opublikowano w aplikacji, gdy użytkownik anuluje działania dziennika aplikacji. Wiadomość jest publikowana za pomocą uchwytu okna NULL.

#define WM_CANCELJOURNAL                0x004B

Parametry

wParam

Ten parametr nie jest używany.

lParam

Ten parametr nie jest używany.

Wartość zwracana

Typ: void

Ten komunikat nie zwraca wartości. Ma być przetwarzany z poziomu pętli głównej aplikacji lub procedury haka GetMessage, a nie z procedury okna.

Uwagi

Tryby rejestrowania i odtwarzania są trybami nakładanymi na system, który pozwala aplikacji sekwencyjnie rejestrować lub odtwarzać dane wejściowe użytkownika. System wprowadza te tryby, gdy aplikacja instaluje procedurę JournalRecordProc lub JournalPlaybackProc. Gdy system znajduje się w jednym z tych trybów rejestrowania, aplikacje muszą z kolei odczytywać dane wejściowe z kolejki wejściowej. Jeśli jakakolwiek aplikacja przestanie odczytywać dane wejściowe, gdy system jest w trybie dziennika, inne aplikacje są zmuszone czekać.

Aby zapewnić niezawodny system, który nie może być nie odpowiadać przez jedną aplikację, system automatycznie anuluje wszystkie działania dziennika, gdy użytkownik naciska CTRL+ESC lub CTRL+ALT+DEL. Następnie system odłącza wszystkie procedury punktów zaczepienia dziennika i publikuje komunikat WM_CANCELJOURNAL, z uchwytem okna NULL, do aplikacji, która ustawiła hak dziennika.

Komunikat WM_CANCELJOURNAL ma dojście NULL, dlatego nie można go wysłać do procedury okna. Istnieją dwa sposoby wyświetlenia komunikatu WM_CANCELJOURNAL przez aplikację: jeśli aplikacja jest uruchomiona we własnej pętli głównej, musi przechwycić komunikat między wywołaniem getMessage lub PeekMessage i wywołaniem polecenia DispatchMessage. Jeśli aplikacja nie działa we własnej pętli głównej, musi ustawić GetMsgProc procedury zaczepienia (za pomocą wywołania SetWindowsHookEx określania typu haka WH_GETMESSAGE), który obserwuje komunikat.

Gdy aplikacja widzi komunikat WM_CANCELJOURNAL, może przyjąć dwie rzeczy: użytkownik celowo anulował rekord dziennika lub tryb odtwarzania, a system już nie włączył żadnych procedur wpisów dziennika lub odtwarzania.

Pamiętaj, że kombinacje wymienione powyżej (CTRL+ESC lub CTRL+ALT+DEL) powodują anulowanie dziennika przez system. Jeśli jedna aplikacja nie odpowiada, daje użytkownikowi środki odzyskiwania. VK_CANCEL kod klucza wirtualnego (zwykle zaimplementowany jako kombinacja CTRL+BREAK) jest to, co aplikacja w trybie rejestrowania dziennika powinna obserwować jako sygnał, że użytkownik chce anulować działanie dziennika. Różnica polega na tym, że obserwowanie VK_CANCEL jest sugerowanym zachowaniem w przypadku rejestrowania aplikacji, podczas gdy CTRL+ESC lub CTRL+ALT+DEL powoduje, że system anuluje rejestrowanie niezależnie od zachowania aplikacji dziennika.

Wymagania

Zobacz też

Odniesienie

JournalPlaybackProc

JournalRecordProc

GetMsgProc

SetWindowsHookEx

Pojęciowe

haków