FwpsQueryConnectionSioFormatRedirectRecords0 関数 (fwpsk.h)

[アーティクル]
08/07/2023

FwpsQueryConnectionSioFormatRedirectRecords0 関数は、リダイレクトされた接続の接続リダイレクトレコードを返します。リダイレクトの詳細については、「バインドまたは接続リダイレクトの使用」を参照してください。

注FwpsQueryConnectionSioFormatRedirectRecords0 は、 FwpsQueryConnectionSioFormatRedirectRecords の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
  [in]            HANDLE  RedirectRecords,
  [out, optional] PVOID   OutputBuffer,
  [in]            SIZE_T  OutputBufferLength,
  [out, optional] PSIZE_T BytesTransferred
);

パラメーター

[in] RedirectRecords

リダイレクトレコードは、ALE_CONNECT_REDIRECT吹き出し関数が classifyFn 関数の inMetaValues パラメーターで受け取った処理を処理します。このハンドルは、FWPS_INCOMING_METADATA_VALUES0構造体の redirectRecords メンバーにあります。

WFP リダイレクトレコードは、リダイレクトされた接続と元の接続が論理的に関連付けられるように、送信プロキシ接続で WFP が設定する必要がある不透明なデータのバッファーです。

[out, optional] OutputBuffer

リダイレクトレコードを受信する出力バッファーへのポインター。バッファーはポインターアラインされている必要があります。

[in] OutputBufferLength

出力バッファーのサイズ (バイト単位)。

[out, optional] BytesTransferred

転送されたバイト数を受け取る変数へのポインター。戻り値が STATUS_BUFFER_TOO_SMALL場合、このパラメーターは必要なバッファーサイズを受け取ります。

戻り値

次のいずれかの NTSTATUS 値を返します。

リターンコード	説明
STATUS_BUFFER_TOO_SMALL	出力バッファーが小さすぎて、転送するすべてのバイトが含まれなかった。データ転送に失敗し、必要なバッファーサイズは BytesTransferred パラメーターで確認できます。
STATUS_NOT_FOUND	RedirectRecords パラメーターが null でした。

注釈

FwpsQueryConnectionSioFormatRedirectRecords0 関数は、ローカルプロキシにのみ適用されます。

リダイレクトの詳細については、「バインドまたは接続リダイレクトの使用」を参照してください。

FwpsQueryConnectionSioFormatRedirectRecords0 関数は、実際のリモートエンドポイントに接続できることを確認するまで、リダイレクトされた接続を受け入れない WFP 接続リダイレクトコールアウトドライバーによって使用されるように設計されています。これを行うには、コールアウトドライバーは、 FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 または FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 レイヤーでリダイレクトされた接続要求をペンドし、 FwpsQueryConnectionSioFormatRedirectRecords0 を呼び出して接続リダイレクトレコードを取得します。このレコードは、コールアウトドライバーがプロキシに送信して、SIO_SET_WFP_CONNECTION_REDIRECT_RECORDSの呼び出しで使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	<=DISPATCH_LEVEL