Funzione CallMsgFilterA (winuser.h)

Articolo
03/15/2023

Passa il messaggio e il codice di hook specificati alle procedure di hook associate ai WH_SYSMSGFILTER e WH_MSGFILTER hook. Una WH_SYSMSGFILTERo WH_MSGFILTER routine hook è una funzione di callback definita dall'applicazione che esamina e, facoltativamente, modifica i messaggi per una finestra di dialogo, una finestra di messaggio, un menu o una barra di scorrimento.

Sintassi

BOOL CallMsgFilterA(
  [in] LPMSG lpMsg,
  [in] int   nCode
);

Parametri

[in] lpMsg

Tipo: LPMSG

Puntatore a una struttura MSG che contiene il messaggio da passare alle procedure di hook.

[in] nCode

Tipo: int

Codice definito dall'applicazione usato dalla routine hook per determinare come elaborare il messaggio. Il codice non deve avere lo stesso valore dei codici di hook definiti dal sistema (MSGF_ e HC_) associati ai WH_SYSMSGFILTER eai WH_MSGFILTER hook.

Valore restituito

Tipo: BOOL

Se l'applicazione deve elaborare ulteriormente il messaggio, il valore restituito è zero.

Se l'applicazione non deve elaborare ulteriormente il messaggio, il valore restituito è diverso da zero.

Commenti

Il sistema chiama CallMsgFilter per consentire alle applicazioni di esaminare e controllare il flusso di messaggi durante l'elaborazione interna delle finestre di dialogo, delle finestre di messaggio, dei menu e delle barre di scorrimento oppure quando l'utente attiva una finestra diversa premendo la combinazione di tasti ALT+TAB.

Installare questa procedura di hook usando la funzione SetWindowsHookEx .

Esempio

Per un esempio, vedere WH_MSGFILTER e WH_SYSMSGFILTER Hook.

Nota

L'intestazione winuser.h definisce CallMsgFilter come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-message-l1-1-0 (introdotto in Windows 8)