Condividi tramite


WM_CANCELJOURNAL messaggio

Avviso

Le API di journaling Hooks non sono supportate a partire da Windows 11 e verranno rimosse in una versione futura. A causa di questo, è consigliabile chiamare invece l'API SendInput TextInput .

Inviato a un'applicazione quando un utente annulla le attività di journaling dell'applicazione. Il messaggio viene pubblicato con un handle di finestra NULL .

#define WM_CANCELJOURNAL                0x004B

Parametri

wParam

Questo parametro non viene usato.

lParam

Questo parametro non viene usato.

Valore restituito

Tipo: void

Questo messaggio non restituisce un valore. È destinato a essere elaborato dall'interno del ciclo principale di un'applicazione o da una routine di hook GetMessage , non da una routine di finestra.

Commenti

Le modalità di registrazione e riproduzione del journal sono modalità imposte dal sistema che consentono a un'applicazione di registrare o riprodurre in sequenza l'input utente. Il sistema entra in queste modalità quando un'applicazione installa una routine hook JournalRecordProc o JournalPlaybackProc . Quando il sistema si trova in una di queste modalità di journaling, le applicazioni devono passare alla lettura dell'input dalla coda di input. Se un'applicazione smette di leggere l'input mentre il sistema si trova in modalità journaling, altre applicazioni devono attendere.

Per garantire un sistema affidabile, uno che non può essere reso non risponde da un'applicazione, il sistema annulla automaticamente tutte le attività di journaling quando un utente preme CTRL+ESC o CTRL+ALT+DEL. Il sistema annulla quindi qualsiasi procedura di hook di journaling e pubblica un messaggio di WM_CANCELJOURNAL , con un handle di finestra NULL , all'applicazione che imposta l'hook di journaling.

Il messaggio WM_CANCELJOURNAL ha un handle di finestra NULL , pertanto non può essere inviato a una routine di finestra. Esistono due modi per visualizzare un messaggio di WM_CANCELJOURNAL per un'applicazione: se l'applicazione è in esecuzione nel proprio ciclo principale, deve rilevare il messaggio tra la chiamata a GetMessage o PeekMessage e la relativa chiamata a DispatchMessage. Se l'applicazione non è in esecuzione nel proprio ciclo principale, deve impostare una procedura di hook GetMsgProc (tramite una chiamata a SetWindowsHookEx che specifica il tipo di hook WH_GETMESSAGE ) che controlla il messaggio.

Quando un'applicazione visualizza un messaggio di WM_CANCELJOURNAL , può presupporre due cose: l'utente ha intenzionalmente annullato la modalità di registrazione o riproduzione del journal e il sistema ha già scollegato eventuali procedure di registrazione o di riproduzione del journal.

Si noti che le combinazioni di tasti indicate in precedenza (CTRL+ESC o CTRL+ALT+DEL) causano l'annullamento del journal. Se un'applicazione viene resa non risponde, dà all'utente un mezzo di ripristino. Il codice della chiave virtuale VK_CANCEL (in genere implementato come combinazione di tasti CTRL+BREAK) è ciò che un'applicazione in modalità record del journal deve watch per come segnale che l'utente desidera annullare l'attività di journaling. La differenza è che la visualizzazione di VK_CANCEL è un comportamento consigliato per le applicazioni di journaling, mentre CTRL+ESC o CTRL+ALT+DEL causano l'annullamento del journaling indipendentemente dal comportamento di un'applicazione di journaling.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Winuser.h (include Windows.h)

Vedi anche

Riferimento

JournalPlaybackProc

JournalRecordProc

GetMsgProc

Setwindowshookex

Informazioni concettuali

Hook