WM_CANCELJOURNAL mensagem

Postado em um aplicativo quando um usuário cancela as atividades de diário do aplicativo. A mensagem é postada com um identificador de janela NULL.

#define WM_CANCELJOURNAL                0x004B

Parâmetros

wParam

Esse parâmetro não é usado.

lParam

Esse parâmetro não é usado.

Valor de retorno

Tipo: nulo

Essa mensagem não retorna um valor. Ele deve ser processado de dentro do loop principal de um aplicativo ou de um procedimento de GetMessage gancho, não de um procedimento de janela.

Observações

Os modos de registro e reprodução de diário são modos impostos ao sistema que permitem que um aplicativo registre ou reproduza sequencialmente a entrada do usuário. O sistema entra nesses modos quando um aplicativo instala umJournalRecordProc ou journalPlaybackProc procedimento de gancho. Quando o sistema está em qualquer um desses modos de diário, os aplicativos devem se reativar lendo a entrada da fila de entrada. Se um aplicativo parar de ler a entrada enquanto o sistema estiver em um modo de diário, outros aplicativos serão forçados a aguardar.

Para garantir um sistema robusto, que não pode responder por nenhum aplicativo, o sistema cancela automaticamente as atividades de diário quando um usuário pressiona CTRL+ESC ou CTRL+ALT+DEL. Em seguida, o sistema desabilita todos os procedimentos de gancho de diário e posta uma mensagem de WM_CANCELJOURNAL, com um identificador de janela NULL, no aplicativo que define o gancho de diário.

A mensagem WM_CANCELJOURNAL tem um identificador de janela NULL, portanto, não pode ser expedido para um procedimento de janela. Há duas maneiras de um aplicativo ver uma mensagem de WM_CANCELJOURNAL: se o aplicativo estiver em execução em seu próprio loop principal, ele deverá capturar a mensagem entre sua chamada para GetMessage ou PeekMessage e sua chamada para DispatchMessage. Se o aplicativo não estiver em execução em seu próprio loop principal, ele deverá definir um procedimento de GetMsgProc hook (por meio de uma chamada para SetWindowsHookEx especificando o tipo de gancho WH_GETMESSAGE) que observa a mensagem.

Quando um aplicativo vê uma mensagem de WM_CANCELJOURNAL, ele pode assumir duas coisas: o usuário cancelou intencionalmente o registro de diário ou o modo de reprodução e o sistema já desachou qualquer registro de diário ou procedimentos de gancho de reprodução.

Observe que as combinações de teclas mencionadas acima (CTRL+ESC ou CTRL+ALT+DEL) fazem com que o sistema cancele o diário. Se qualquer aplicativo não responder, ele fornecerá ao usuário um meio de recuperação. O VK_CANCEL código de chave virtual (geralmente implementado como a combinação de teclas CTRL+BREAK) é o que um aplicativo que está no modo de registro de diário deve observar como um sinal de que o usuário deseja cancelar a atividade de diário. A diferença é que observar VK_CANCEL é um comportamento sugerido para aplicativos de diário, enquanto CTRL+ESC ou CTRL+ALT+DEL fazem com que o sistema cancele o diário independentemente do comportamento de um aplicativo de diário.

Requisitos

Consulte também

Referência

JournalPlaybackProc

JournalRecordProc

GetMsgProc

SetWindowsHookEx

Conceitual

Hooks