FWPS_BIND_REQUEST0結構（fwpsk.h）

發行項
02/07/2025

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 值的節點為止。