FwpsRedirectHandleCreate0 関数 (fwpsk.h)

  • [アーティクル]

FwpsRedirectHandleCreate0 関数は、接続リダイレクト関数が接続をローカル プロセスにリダイレクトするために使用できるハンドルを作成します。 リダイレクトの詳細については、「 バインドまたは接続リダイレクトの使用」を参照してください。

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

 

構文

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

パラメーター

providerGuid

プロバイダー GUID。

flags

予約済み。 0 に設定します。

redirectHandle

ハンドルを受け取る変数へのポインター。

戻り値

FwpsRedirectHandleCreate0 関数は、次の NTSTATUS コードのいずれかを返します。

リターン コード 説明
STATUS_SUCCESS
 リダイレクト ハンドルが正常に返されました。 redirectHandle パラメーターが指す変数にハンドルが含まれています。
その他の状態コード
 エラーが発生しました。

解説

コールアウト ドライバーは 、FwpsRedirectHandleCreate0 関数を呼び出して、接続のリダイレクトに使用できるハンドルを作成します。

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

吹き出しドライバーは 、FwpsRedirectHandleCreate0 を 1 回呼び出し、ハンドルを再利用できるようにハンドルをキャッシュする必要があります。

アプリケーション層強制 (ALE) 接続リダイレクト呼び出しで接続をローカル プロセスにリダイレクトできるようにするには、 FwpsRedirectHandleCreate0 関数を使用してリダイレクト ハンドルを取得し、そのハンドルを FWPS_CONNECT_REQUEST0 構造体に配置する必要があります。 吹き出しは、ALE 接続リダイレクト レイヤーの classifyFn の構造を変更します。

コールアウト ドライバーは、リダイレクト ハンドルの使用を終了した後、 FwpsRedirectHandleDestroy0 関数を呼び出してハンドルを破棄する必要があります。

要件

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

こちらもご覧ください

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn