FWPS_BIND_REQUEST0 結構 (fwpsk.h)

發行項
02/29/2024

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

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

語法

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

成員

localAddressAndPort

系結要求的本機傳輸位址。這是 IPV4 或 IPV6 位址，以及格式化為 SOCKADDR_STORAGE 結構的 TCP/UDP 埠。

portReservationToken

用來保留適當埠的令牌。呼叫 CreatePersistentTcpPortReservation 或 CreatePersistentUdpPortReservation 來保留埠時，就會取得令牌。這兩個保留函式都可以在iphlpapi.h中找到。

previousVersion

舊版的系結要求數據。這個只讀欄位會記錄系結要求的修改歷程記錄。此成員會預先初始化，其指標為單向連結清單，並將索引設定為目前FWPS_BIND_REQUEST0數據的記錄。

modifierFilterId

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

備註

圖說文字驅動程式藉由呼叫來取得這個結構 FwpsAcquireWritableLayerDataPointer0 函式，它會透過 writableLayerData 參數傳回FWPS_BIND_REQUEST0結構的指標。

classifyFn 函式可以修改系結要求的參數，例如將本機傳輸位址或埠重新導向至另一個位址或埠。如果修改系結要求的參數，則為
classifyFn 函式必須執行下列動作：

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

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