struttura FWPS_CONNECT_REQUEST0 (fwpsk.h)

Articolo
02/07/2025

La struttura FWPS_CONNECT_REQUEST0 definisce i dati modificabili per i livelli FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4 e FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6. Il driver callout usa questi dati per esaminare o modificare le informazioni di connessione.

NotaFWPS_CONNECT_REQUEST0 è una versione specifica di FWPS_CONNECT_REQUEST. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

typedef struct _FWPS_CONNECT_REQUEST0 {
  SOCKADDR_STORAGE              localAddressAndPort;
  SOCKADDR_STORAGE              remoteAddressAndPort;
  UINT64                        portReservationToken;
  DWORD                         localRedirectTargetPID;
  struct _FWPS_CONNECT_REQUEST0 *previousVersion;
  UINT64                        modifierFilterId;
  HANDLE                        localRedirectHandle;
  void                          *localRedirectContext;
  SIZE_T                        localRedirectContextSize;
} FWPS_CONNECT_REQUEST0;

Membri

localAddressAndPort

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

remoteAddressAndPort

Indirizzo di trasporto remoto della richiesta di connessione. 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.

localRedirectTargetPID

Identificatore del processo host locale che gestirà il traffico verso l'indirizzo specificato in localAddressAndPort. Questo valore deve essere impostato per le modifiche di reindirizzamento loopback da accettare dal motore.

previousVersion

Versione precedente dei dati della richiesta di connessione. Questo campo di sola lettura registra la cronologia delle modifiche della richiesta di connessione. Se i dati della richiesta di connessione non sono stati modificati in precedenza da un altro filtro WFP, previousVersion verrà impostato su NULL.

modifierFilterId

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

localRedirectHandle

Handle di reindirizzamento creato dal driver callout chiamando la funzione FwpsRedirectHandleCreate0.

Nota A partire da Windows 8, il localRedirectHandle deve essere popolato per il funzionamento del reindirizzamento.

localRedirectContext

Area di contesto del driver callout allocata dal driver callout chiamando la funzione ExAllocatePoolWithTag.

Nota A partire da Windows 8, la memoria allocata per localRedirectContext avrà la proprietà acquisita dal WFP e verrà liberata quando il flusso proxy viene rimosso.

localRedirectContextSize

Dimensioni, in byte, dell'area di contesto fornita dal callout.

Nota Supportato a partire da Windows 8.

Osservazioni

Il driver callout ottiene questa struttura chiamando il funzione fwpsAcquireWritableLayerDataPointer0, che restituisce un puntatore a una struttura FWPS_CONNECT_REQUEST0 tramite il parametro writableLayerData. La funzione di classifyFn può modificare i parametri della richiesta di connessione, ad esempio reindirizzando l'indirizzo di trasporto locale o remoto o la porta a un altro indirizzo o porta. Se modifica i parametri della richiesta di connessione, la funzione classifyFn deve eseguire le operazioni seguenti:

Apportare tutte le modifiche alla struttura FWPS_CONNECT_REQUEST0 restituita da FwpsAcquireWritableLayerDataPointer0. È possibile modificare solo remoteAddressAndPort, portReservationToken, localRedirectTargetPID, localRedirectHandle, localRedirectContexte localRedirectContextSize membri.
Chiamare FwpsApplyModifiedLayerData0 con il parametro modifiedLayerData impostato sull'indirizzo della struttura FWPS_CONNECT_REQUEST0, anche se il driver del callout non ha modificato alcun dato. Questo valore deve essere uguale al valore del parametro modifiedLayerData restituito tramite 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 viene impostato su NULL.