WM_CANCELJOURNAL mensagem
Aviso
As APIs de Ganchos de Registro no Diário não têm suporte a partir de Windows 11 e serão removidas em uma versão futura. Por isso, é altamente recomendável chamar a API SendInput TextInput.
Postado em um aplicativo quando um usuário cancela as atividades de registro no diário do aplicativo. A mensagem é postada com um identificador de janela NULL .
#define WM_CANCELJOURNAL 0x004B
Parâmetros
-
wParam
-
Este parâmetro não é usado.
-
lParam
-
Este parâmetro não é usado.
Valor retornado
Tipo: void
Esta mensagem não retorna um valor. Ele deve ser processado de dentro do loop main de um aplicativo ou de um procedimento de gancho GetMessage, não de um procedimento de janela.
Comentários
Os modos de reprodução e registro de diário são modos impostos ao sistema que permitem que um aplicativo grave ou reproduza sequencialmente a entrada do usuário. O sistema entra nesses modos quando um aplicativo instala um procedimento de gancho JournalRecordProc ou JournalPlaybackProc . Quando o sistema está em qualquer um desses modos de diário, os aplicativos devem se revezar na leitura de entrada da fila de entrada. Se qualquer 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 ser responsivo por qualquer aplicativo, o sistema cancela automaticamente as atividades de registro em diário quando um usuário pressiona CTRL+ESC ou CTRL+ALT+DEL. Em seguida, o sistema desincroniza todos os procedimentos de gancho de registro em diário e posta uma mensagem WM_CANCELJOURNAL , com um identificador de janela NULL , para o aplicativo que define o gancho de registro no diário.
A mensagem WM_CANCELJOURNAL tem um identificador de janela NULL , portanto, não pode ser expedida para um procedimento de janela. Há duas maneiras de um aplicativo ver uma mensagem WM_CANCELJOURNAL: se o aplicativo estiver em execução em seu próprio loop main, 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 main, ele deverá definir um procedimento de gancho GetMsgProc (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 registro em 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 watch como um sinal de que o usuário deseja cancelar a atividade de registro no diário. A diferença é que observar VK_CANCEL é um comportamento sugerido para aplicativos de registro em diário, enquanto CTRL+ESC ou CTRL+ALT+DEL fazem com que o sistema cancele o registro no diário, independentemente do comportamento de um aplicativo de registro em diário.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também
-
Referência
-
Conceitual