FWPS_CONNECT_REQUEST0 結構 (fwpsk.h)

發行項
02/29/2024

FWPS_CONNECT_REQUEST0 結構會定義FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4和FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6層的可修改數據。圖說文字驅動程式會使用此數據來檢查或修改連線資訊。

請注意，FWPS_CONNECT_REQUEST0 是特定版本的 FWPS_CONNECT_REQUEST。如需詳細資訊，請參閱 Version-Independent 名稱和以特定 Windows 版本為目標。

語法

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;

成員

localAddressAndPort

線上要求的本機傳輸位址。這是 IPV4 或 IPV6 位址和格式化為 SOCKADDR_STORAGE 結構的 TCP 連接埠。

remoteAddressAndPort

線上要求的遠端傳輸位址。這是 IPV4 或 IPV6 位址，以及格式化為 SOCKADDR_STORAGE 結構的 TCP/UDP 埠。

portReservationToken

用來保留適當埠的令牌。呼叫 CreatePersistentTcpPortReservation 或 CreatePersistentUdpPortReservation 來保留埠時，就會取得令牌。

localRedirectTargetPID

將處理 localAddressAndPort 中所指定位址之流量的本機主機進程進程標識碼。此值必須設定，才能讓引擎接受回送重新導向變更。

previousVersion

舊版的連線要求數據。這個唯讀欄位會記錄連線要求的修改歷程記錄。如果連線要求數據先前尚未由另一個一個一個的一個的一個

modifierFilterId

classifyFn 函式篩選參數之 FilterId 成員的值。如需 FilterId 成員的詳細資訊，請參閱 FWPS_FILTER1。

localRedirectHandle

呼叫 FwpsRedirectHandleCreate0 函式所建立之圖說文字驅動程式的重新導向句柄。

注意從 Windows 8 開始，必須填入localRedirectHandle，重新導向才能運作。

localRedirectContext

呼叫 ExAllocatePoolWithTag 函式所配置的圖說文字驅動程式內容區域。

注意從 Windows 8 開始，配置給localRedirectContext的記憶體會擁有其由一開始的存取權，並在移除 Proxy流程時釋出。

localRedirectContextSize

圖說文字提供內容區域的大小，以位元組為單位。

注意從 Windows 8 開始支援。

備註

圖說文字驅動程式會藉由呼叫來取得此結構 FwpsAcquireWritableLayerDataPointer0 函式，它會透過 writableLayerData 參數傳回FWPS_CONNECT_REQUEST0結構的指標。 classifyFn 函式可以修改連線要求的參數，例如將本機或遠端傳輸位址或埠重新導向至另一個位址或埠。如果修改連線要求的參數， 則 classifyFn 函式必須執行下列動作：

對 FwpsAcquireWritableLayerDataPointer0 所傳回FWPS_CONNECT_REQUEST0結構進行所有變更。只能修改 remoteAddressAndPort、 portReservationToken、 localRedirectTargetPID、 localRedirectHandle、 localRedirectContext 和 localRedirectContextSize 成員。
呼叫 FwpsApplyModifiedLayerData0 且 modifiedLayerData 參數設定為 FWPS_CONNECT_REQUEST0 結構的位址，即使圖說文字驅動程式未修改任何數據也一樣。這個值必須與透過傳回的 modifiedLayerData 參數值相同 FwpsAcquireWritableLayerDataPointer0。

此結構可作為連結清單，其中包含其他圖說文字驅動程式所做的所有變更記錄。如果 previousVersion 成員不是 NULL，則會有舊版資訊。若要檢查完整的版本歷程記錄，圖說文字驅動程式必須繼續檢查清單中每個結構的 previousVersion 成員，直到它設定為 NULL 為止。