estructura FWPS_BIND_REQUEST0 (fwpsk.h)

Artículo
02/07/2025

La estructura FWPS_BIND_REQUEST0 define 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. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

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

Token usado 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 singly con el índice establecido en el registro de los datos de FWPS_BIND_REQUEST0 actuales.

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.

Observaciones

El controlador de llamada obtiene esta estructura llamando a función fwpsAcquireWritableLayerDataPointer0, que devuelve un puntero a una estructura de 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,
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 localAddressAndPort y portReservationToken miembros.
Llamar 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 modifiedLayerData valor de parámetro 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 de NULL.