structure FWPS_BIND_REQUEST0 (fwpsk.h)

Article
08/07/2023

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.

NotezFWPS_BIND_REQUEST0 est une version spécifique de FWPS_BIND_REQUEST. Pour plus d’informations , voir 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 en tant que 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 se trouvent dans iphlpapi.h.

previousVersion

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

modifierFilterId

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

Remarques

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

La fonction classifyFn peut modifier les paramètres de la demande de liaison, par exemple rediriger l’adresse de transport ou le port local vers une autre adresse ou port. S’il modifie les paramètres de la demande de liaison, le
La fonction classififn 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 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é les données. Cette valeur doit être identique à la valeur du 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édente si le membre previousVersion n’est pas NULL. Pour examiner l’historique complet des versions, 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.