estructura FWPS_CONNECT_REQUEST0 (fwpsk.h)

2025-02-07

La estructura FWPS_CONNECT_REQUEST0 define datos modificables para las capas de FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4 y FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6. El controlador de llamada usa estos datos para inspeccionar o modificar la información de conexión.

NotaFWPS_CONNECT_REQUEST0 es una versión específica de FWPS_CONNECT_REQUEST. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Sintaxis

typedef struct _FWPS_CONNECT_REQUEST0 {
  SOCKADDR_STORAGE              localAddressAndPort;
  SOCKADDR_STORAGE              remoteAddressAndPort;
  UINT64                        portReservationToken;
  DWORD                         localRedirectTargetPID;
  struct _FWPS_CONNECT_REQUEST0 *previousVersion;
  UINT64                        modifierFilterId;
  HANDLE                        localRedirectHandle;
  void                          *localRedirectContext;
  SIZE_T                        localRedirectContextSize;
} FWPS_CONNECT_REQUEST0;

Miembros

localAddressAndPort

Dirección de transporte local de la solicitud de conexión. Se trata de una dirección IPV4 o IPV6 y un puerto TCP con formato de estructura SOCKADDR_STORAGE.

remoteAddressAndPort

Dirección de transporte remota de la solicitud de conexión. Se trata de una dirección IPV4 o IPV6 y un puerto TCP/UDP con formato de estructura SOCKADDR_STORAGE.

portReservationToken

Token usado para reservar el puerto adecuado. El token se obtiene cuando se reserva un puerto mediante una llamada a CreatePersistentTcpPortReservation o CreatePersistentUdpPortReservation.

localRedirectTargetPID

Identificador de proceso del proceso de host local que controlará el tráfico a la dirección especificada en localAddressAndPort. Este valor debe establecerse para que el motor acepte los cambios de redirección de bucle invertido.

previousVersion

La versión anterior de los datos de solicitud de conexión. Este campo de solo lectura registra el historial de modificaciones de la solicitud de conexión. Si otro filtro DEL PMA no ha modificado previamente los datos de la solicitud de conexión, anteriorVersion se establecerá en NULL.

modifierFilterId

Valor del miembro filterId de de la función classifyFnfiltro parámetro. Para obtener más información sobre el miembro FilterId de, vea FWPS_FILTER1.

localRedirectHandle

Identificador de redirección que creó el controlador de llamada llamando a la función FwpsRedirectHandleCreate0.

Nota a partir de Windows 8, el localRedirectHandle debe rellenarse para que funcione el redireccionamiento.

localRedirectContext

Área de contexto del controlador de llamada que asignó el controlador de llamada llamando a la función ExAllocatePoolWithTag.

Nota a partir de Windows 8, la memoria asignada para localRedirectContext tendrá su propiedad tomada por EL PMA y se liberará cuando se quite el flujo proxy.

localRedirectContextSize

Tamaño, en bytes, del área de contexto proporcionada por la llamada.

Nota Compatible a partir de Windows 8.

Observaciones

El controlador de llamada obtiene esta estructura llamando a función FwpsAcquireWritableLayerDataPointer0, que devuelve un puntero a una estructura FWPS_CONNECT_REQUEST0 a través del parámetro writableLayerData. La función clasificarFn puede modificar los parámetros de la solicitud de conexión, como redirigir la dirección de transporte local o remota o el puerto a otra dirección o puerto. Si modifica los parámetros de la solicitud de conexión, la función clasifiqueFn debe hacer lo siguiente:

Realice todos los cambios en la estructura FWPS_CONNECT_REQUEST0 devuelta por FwpsAcquireWritableLayerDataPointer0. Solo se pueden modificar los remoteAddressAndPort, portReservationToken , localRedirectTargetPID, localRedirectHandle, localRedirectContexty miembros localRedirectContextSize.
Llamar fwpsApplyModifiedLayerData0 con el parámetro modifiedLayerData establecido en la dirección de la estructura FWPS_CONNECT_REQUEST0, incluso si el controlador de llamada no modificó ningún dato. Este valor debe ser el mismo que el modifiedLayerData valor de parámetro devuelto a través de FwpsAcquireWritableLayerDataPointer0.

Esta estructura actúa como una lista vinculada que contiene un registro de todos los cambios realizados por otros controladores de llamada. Hay información de versión anterior si el miembro previousVersion no es NULL. Para examinar el historial de versiones completo, el controlador de llamada debe seguir examinando el miembro previousVersion de cada estructura de la lista hasta que se establezca en NULL.