Estructura CHANGEFILTERSTRUCT (winuser.h)

Contiene información de resultados extendida obtenida mediante una llamada a la función ChangeWindowMessageFilterEx .

Sintaxis

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

Miembros

cbSize

Tipo: DWORD

El tamaño de la estructura en bytes. Debe establecerse sizeof(CHANGEFILTERSTRUCT)en ; de lo contrario, se produce un error en la función con ERROR_INVALID_PARAMETER.

ExtStatus

Tipo: DWORD

Si la función se realiza correctamente, este campo contiene uno de los valores siguientes.

Value	Significado
MSGFLTINFO_NONE 0	Consulte la sección Comentarios. Se aplica a MSGFLT_ALLOW y MSGFLT_DISALLOW.
MSGFLTINFO_ALLOWED_HIGHER 3	El mensaje se permite en un ámbito superior a la ventana. Se aplica a MSGFLT_DISALLOW.
MSGFLTINFO_ALREADYALLOWED_FORWND 1	El filtro de mensajes de esta ventana ya ha permitido el mensaje y la función se realizó correctamente sin ningún cambio en el filtro de mensajes de la ventana. Se aplica a MSGFLT_ALLOW.
MSGFLTINFO_ALREADYDISALLOWED_FORWND 2	El filtro de mensajes de esta ventana ya ha bloqueado el mensaje y la función se realizó correctamente sin ningún cambio en el filtro de mensajes de la ventana. Se aplica a MSGFLT_DISALLOW.

Observaciones

Se requieren determinados mensajes cuyo valor sea menor que WM_USER para pasar por el filtro, independientemente de la configuración del filtro. No habrá ningún efecto al intentar usar esta función para permitir o bloquear dichos mensajes.

Una aplicación puede usar la función ChangeWindowMessageFilter para permitir o bloquear un mensaje de una manera de todo el proceso. Si el mensaje lo permite el filtro de mensajes de proceso o el filtro de mensajes de la ventana, se entregará a la ventana.

En la tabla siguiente se enumeran los valores posibles devueltos en ExtStatus.

Mensaje ya permitido en un ámbito superior	El mensaje ya está permitido por el filtro de mensajes de la ventana	Operación solicitada	Indicador devuelto en ExtStatus cuando se ha realizado correctamente
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

Requisitos

Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluir Windows.h)

Consulte también

ChangeWindowMessageFilterEx