struttura FWPS_BIND_REQUEST0 (fwpsk.h)

Articolo
02/07/2025

La struttura FWPS_BIND_REQUEST0 definisce i dati modificabili per i livelli FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 e FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Il driver callout usa questi dati per esaminare 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 selezione di 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;

Membri

localAddressAndPort

Indirizzo di trasporto locale della richiesta di associazione. Si tratta di un indirizzo IPV4 o IPV6 e di 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 preinitializzato con un puntatore a un elenco collegato singly con l'indice impostato sul record per i dati di FWPS_BIND_REQUEST0 correnti.

modifierFilterId

Valore del membro FilterId del parametro classifyFn funzione di filtro . Per altre informazioni sul membro FilterId, vedere FWPS_FILTER1.

Osservazioni

Il driver callout ottiene questa struttura chiamando il funzione fwpsAcquireWritableLayerDataPointer0, che restituisce un puntatore a una struttura FWPS_BIND_REQUEST0 tramite il parametro writableLayerData.

La funzione di classifyFn può modificare i parametri della richiesta di associazione, ad esempio reindirizzando l'indirizzo di trasporto locale o la porta a un altro indirizzo o porta. Se modifica i parametri della richiesta di associazione,
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.
Chiamare FwpsApplyModifiedLayerData0 con il parametro modifiedLayerData impostato sull'indirizzo della struttura FWPS_BIND_REQUEST0, anche se il driver del 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 che contiene un record di tutte le modifiche apportate da altri driver callout. Sono disponibili informazioni sulla versione precedenti se il membro previousVersion non è NULL. Per esaminare la cronologia delle versioni completa, il driver callout deve continuare a esaminare il precedenteVersion membro di ogni struttura nell'elenco finché non trova un nodo con questo membro impostato su un valore NULL.