estructura FWPS_BIND_REQUEST0 (fwpsk.h)

Artículo
08/07/2023

La estructura FWPS_BIND_REQUEST0 define los datos modificables para las capas FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 y FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. El controlador de llamada usa estos datos para inspeccionar o modificar la información de conexión.

NotaFWPS_BIND_REQUEST0 es una versión específica de FWPS_BIND_REQUEST. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

Sintaxis

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

Miembros

localAddressAndPort

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

portReservationToken

Un token que se usa para reservar el puerto adecuado. El token se obtiene cuando se reserva un puerto mediante una llamada a CreatePersistentTcpPortReservation o CreatePersistentUdpPortReservation. Ambas funciones de reserva se pueden encontrar en iphlpapi.h.

previousVersion

La versión anterior de los datos de solicitud de enlace. Este campo de solo lectura registra el historial de modificaciones de la solicitud de enlace. Este miembro se inicializa previamente con un puntero a una lista vinculada de forma singly con el índice establecido en el registro de los datos de FWPS_BIND_REQUEST0 actuales.

modifierFilterId

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

Comentarios

El controlador de llamada obtiene esta estructura mediante una llamada a . Función FwpsAcquireWritableLayerDataPointer0 , que devuelve un puntero a una estructura FWPS_BIND_REQUEST0 a través del parámetro writableLayerData .

La función classifyFn puede modificar los parámetros de la solicitud de enlace, como redirigir la dirección de transporte local o el puerto a otra dirección o puerto. Si modifica los parámetros de la solicitud de enlace,
La función classifyFn debe hacer lo siguiente:

Realice todos los cambios en la estructura FWPS_BIND_REQUEST0 devuelta por FwpsAcquireWritableLayerDataPointer0. Solo se pueden modificar los miembros localAddressAndPort y portReservationToken .
Call FwpsApplyModifiedLayerData0 con el parámetro modifiedLayerData establecido en la dirección de la estructura FWPS_BIND_REQUEST0 , incluso si el controlador de llamada no modificó ningún dato. Este valor debe ser el mismo que el valor del parámetro modifiedLayerData devuelto por 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 continuar examinando el miembro previousVersion de cada estructura de la lista hasta que encuentre un nodo que tenga este miembro establecido en un valor NULL.