Funzione CallMsgFilterA (winuser.h)
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) |
Vedi anche
Informazioni concettuali
Riferimento