Struttura CHANGEFILTERSTRUCT (winuser.h)

Articolo
03/15/2023

Contiene informazioni estese sui risultati ottenute chiamando la funzione ChangeWindowMessageFilterEx .

Sintassi

typedef struct tagCHANGEFILTERSTRUCT {
  DWORD cbSize;
  DWORD ExtStatus;
} CHANGEFILTERSTRUCT, *PCHANGEFILTERSTRUCT;

Members

cbSize

Tipo: DWORD

Dimensioni della struttura, in byte. Deve essere impostato su sizeof(CHANGEFILTERSTRUCT). In caso contrario, la funzione ha esito negativo con ERROR_INVALID_PARAMETER.

ExtStatus

Tipo: DWORD

Se la funzione ha esito positivo, questo campo contiene uno dei valori seguenti.

Valore	Significato
MSGFLTINFO_NONE 0	Vedere la sezione relativa alle osservazioni. Si applica a MSGFLT_ALLOW e MSGFLT_DISALLOW.
MSGFLTINFO_ALLOWED_HIGHER 3	Il messaggio è consentito in un ambito superiore alla finestra. Si applica a MSGFLT_DISALLOW.
MSGFLTINFO_ALREADYALLOWED_FORWND 1	Il messaggio è già stato consentito dal filtro dei messaggi di questa finestra e la funzione ha quindi avuto esito positivo senza alcuna modifica al filtro del messaggio della finestra. Si applica a MSGFLT_ALLOW.
MSGFLTINFO_ALREADYDISALLOWED_FORWND 2	Il messaggio è già stato bloccato dal filtro del messaggio di questa finestra e la funzione ha quindi avuto esito positivo senza alcuna modifica al filtro del messaggio della finestra. Si applica a MSGFLT_DISALLOW.

Commenti

Alcuni messaggi il cui valore è inferiore a WM_USER devono passare attraverso il filtro, indipendentemente dall'impostazione del filtro. Non vi sarà alcun effetto quando si tenta di usare questa funzione per consentire o bloccare tali messaggi.

Un'applicazione può usare la funzione ChangeWindowMessageFilter per consentire o bloccare un messaggio in modo a livello di processo. Se il messaggio è consentito dal filtro del messaggio di elaborazione o dal filtro del messaggio della finestra, verrà recapitato alla finestra.

Nella tabella seguente sono elencati i valori possibili restituiti in ExtStatus.

Messaggio già consentito nell'ambito superiore	Messaggio già consentito dal filtro messaggi della finestra	Operazione richiesta	Indicatore restituito in ExtStatus in caso di esito positivo
No	No	MSGFLT_ALLOW	MSGFLTINFO_NONE
No	No	MSGFLT_DISALLOW	MSGFLTINFO_ALREADYDISALLOWED_FORWND
No	No	MSGFLT_RESET	MSGFLTINFO_NONE
No	Sì	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
No	Sì	MSGFLT_DISALLOW	MSGFLTINFO_NONE
No	Sì	MSGFLT_RESET	MSGFLTINFO_NONE
Sì	No	MSGFLT_ALLOW	MSGFLTINFO_NONE
Sì	No	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Sì	No	MSGFLT_RESET	MSGFLTINFO_NONE
Sì	Sì	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
Sì	Sì	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Sì	Sì	MSGFLT_RESET	MSGFLTINFO_NONE

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	winuser.h (include Windows.h)

Vedi anche

ChangeWindowMessageFilterEx

Condividi tramite