FWPS_BIND_REQUEST0構造体 (fwpsk.h)

FWPS_BIND_REQUEST0 構造体は、FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4レイヤーとFWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6 レイヤーの変更可能なデータを定義します。 コールアウト ドライバーは、このデータを使用して接続情報を検査または変更します。

注意FWPS_BIND_REQUEST0 は、FWPS_BIND_REQUESTの特定のバージョンです。 詳細については、「WFP 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 データのレコードにインデックスが設定された、1 つのリンクされたリストへのポインターを使用して事前初期化されます。

modifierFilterId

FilterIdclassifyFn 関数の filter パラメーターのメンバーの値。 FilterId メンバーの詳細については、「FWPS_FILTER1」を参照してください。

備考

引き出しドライバーは、次の呼び出しを呼び出すことによって、この構造体を取得します。fwpsAcquireWritableLayerDataPointer0 関数、書き込み可能なLayerData パラメーターを介して FWPS_BIND_REQUEST0 構造体へのポインターを返します。

classifyFn 関数は、ローカル トランスポート アドレスまたはポートを別のアドレスまたはポートにリダイレクトするなど、バインド要求のパラメーターを変更できます。 バインド要求のパラメーターを変更する場合、
classifyFn 関数、次の操作を行う必要があります。

• FwpsAcquireWritableLayerDataPointer0 によって返された FWPS_BIND_REQUEST0 構造体に対するすべての変更行います。 変更できるのは、localAddressAndPort と portReservationToken メンバー だけです。
• 呼び出しfwpsApplyModifiedLayerData0 、modifiedLayerData パラメーターを FWPS_BIND_REQUEST0 構造体のアドレスに設定して します(コールアウト ドライバーがデータを変更しなかった場合でも)。 この値は、によって返された modifiedLayerData パラメーター値と同じである必要がありますFwpsAcquireWritableLayerDataPointer0 をします。

この構造体は、他の引き出し線ドライバーによって行われたすべての変更のレコードを含むリンク リストとして機能します。 previousVersion メンバーが NULL されていない場合は、以前のバージョン情報があります。 完全なバージョン履歴を調べるには、引き出し線ドライバーは、このメンバーが NULL の値に設定されているノードが見つかるまで、リスト内の各構造体の previousVersion メンバー調べ続ける必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 7 以降で使用できます。
ヘッダー	fwpsk.h (Fwpsk.h を含む)

関連項目

FWPS_FILTER1

FwpsAcquireWritableLayerDataPointer0

FwpsApplyModifiedLayerData0

SOCKADDR_STORAGE

classifyFn