次の方法で共有

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
ターゲット プラットフォーム の 万国
ヘッダー fwpsk.h (Fwpsk.h を含む)
ライブラリ Fwpkclnt.lib
IRQL PASSIVE_LEVEL

関連項目

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn