FWPS_BIND_REQUEST0 struttura (fwpsk.h)

Articolo
02/26/2024

La struttura FWPS_BIND_REQUEST0 definisce i dati modificabili per i livelli di FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 e FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Il driver di callout usa questi dati per controllare o modificare le informazioni di connessione.

NotaFWPS_BIND_REQUEST0 è una versione specifica di FWPS_BIND_REQUEST. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Sintassi

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

Members

localAddressAndPort

Indirizzo di trasporto locale della richiesta di associazione. Si tratta di un indirizzo IPV4 o IPV6 e una porta TCP/UDP formattata come struttura SOCKADDR_STORAGE .

portReservationToken

Token usato per riservare la porta appropriata. Il token viene ottenuto quando una porta è riservata chiamando CreatePersistentTcpPortReservation o CreatePersistentUdpPortReservation. Entrambe le funzioni di prenotazione sono disponibili in iphlpapi.h.

previousVersion

Versione precedente dei dati della richiesta di associazione. Questo campo di sola lettura registra la cronologia delle modifiche della richiesta di associazione. Questo membro viene preinitizzato con un puntatore a un elenco collegato con l'indice impostato sul record per i dati di FWPS_BIND_REQUEST0 correnti.

modifierFilterId

Valore del membro FilterId del parametro filterFn della funzione di classificazione. Per altre informazioni sul membro FilterId , vedere FWPS_FILTER1.

Commenti

Il driver di callout ottiene questa struttura chiamando l'oggetto Funzione FwpsAcquireWritableLayerDataPointer0 , che restituisce un puntatore a una struttura FWPS_BIND_REQUEST0 tramite il parametro writableLayerData .

La funzione classificazioneFn può modificare i parametri della richiesta di associazione, ad esempio reindirizzando l'indirizzo del trasporto locale o la porta a un altro indirizzo o porta. Se modifica i parametri della richiesta di associazione,
la funzione classifyFn deve eseguire le operazioni seguenti:

Apportare tutte le modifiche alla struttura FWPS_BIND_REQUEST0 restituita da FwpsAcquireWritableLayerDataPointer0. È possibile modificare solo i membri localAddressAndPort e portReservationToken .
Chiamata FwpsApplyModifiedLayerData0 con il parametro modifiedLayerData impostato sull'indirizzo della struttura FWPS_BIND_REQUEST0 , anche se il driver di callout non ha modificato alcun dato. Questo valore deve essere uguale al valore del parametro modifiedLayerData restituito da FwpsAcquireWritableLayerDataPointer0.

Questa struttura funge da elenco collegato contenente un record di tutte le modifiche apportate da altri driver di callout. Se il membro precedenteVersion non è NULL, è disponibile informazioni sulla versione precedente. Per esaminare la cronologia della versione completa, il driver callout deve continuare a esaminare il membro precedenteVersion di ogni struttura dell'elenco finché non trova un nodo con questo membro impostato su un valore NULL.