structure FWPS_BIND_REQUEST0 (fwpsk.h)

Article
02/07/2025

La structure FWPS_BIND_REQUEST0 définit des données modifiables pour les couches FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 et FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Le pilote de légende utilise ces données pour inspecter ou modifier les informations de connexion.

RemarqueFWPS_BIND_REQUEST0 est une version spécifique de FWPS_BIND_REQUEST. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

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

Membres

localAddressAndPort

Adresse de transport locale de la demande de liaison. Il s’agit d’une adresse IPV4 ou IPV6 et d’un port TCP/UDP mis en forme comme structure SOCKADDR_STORAGE.

portReservationToken

Jeton utilisé pour réserver le port approprié. Le jeton est obtenu lorsqu’un port est réservé en appelant CreatePersistentTcpPortReservation ou CreatePersistentUdpPortReservation. Les deux fonctions de réservation sont disponibles dans iphlpapi.h.

previousVersion

Version précédente des données de demande de liaison. Ce champ en lecture seule enregistre l’historique de modification de la demande de liaison. Ce membre est préinitialisé avec un pointeur vers une liste liée de manière singly avec l’index défini sur l’enregistrement pour les données de FWPS_BIND_REQUEST0 actuelles.

modifierFilterId

Valeur du FilterId membre du paramètre de filtre classifiezFn fonction de filtre . Pour plus d’informations sur le membre FilterId, consultez FWPS_FILTER1.

Remarques

Le pilote de légende obtient cette structure en appelant le fonction FwpsAcquireWritableLayerDataPointerDataPointer0, qui retourne un pointeur vers une structure FWPS_BIND_REQUEST0 via le paramètre writableLayerData.

La fonction classifierFn peut modifier les paramètres de la demande de liaison, tels que la redirection de l’adresse de transport locale ou du port vers une autre adresse ou port. S’il modifie les paramètres de la demande de liaison, le
fonction classifiezFn doit effectuer les opérations suivantes :

Apportez toutes les modifications à la structure FWPS_BIND_REQUEST0 retournée par FwpsAcquireWritableLayerDataPointer0. Seuls les membres localAddressAndPort et portReservationToken peuvent être modifiés.
Appeler paramètre FwpsApplyModifiedLayerData0 avec le paramètre modifiedLayerData défini sur l’adresse de la structure FWPS_BIND_REQUEST0, même si le pilote de légende n’a pas modifié de données. Cette valeur doit être identique à la valeur de paramètre modifiedLayerData retournée par FwpsAcquireWritableLayerDataPointer0.

Cette structure agit comme une liste liée qui contient un enregistrement de toutes les modifications apportées par d’autres pilotes de légende. Il existe des informations de version précédentes si le membre previousVersion n’est pas NULL. Pour examiner l’historique de version complet, le pilote de légende doit continuer à examiner le membre previousVersion de chaque structure de la liste jusqu’à ce qu’il trouve un nœud dont ce membre a la valeur NULL.