FwpsRedirectHandleCreate0 関数 (fwpsk.h)
FwpsRedirectHandleCreate0 関数は、接続リダイレクト関数が接続をローカル プロセスにリダイレクトするために使用できるハンドルを作成します。 リダイレクトの詳細については、「 バインドまたは接続リダイレクトの使用」を参照してください。
構文
NTSTATUS FwpsRedirectHandleCreate0(
const GUID *providerGuid,
UINT32 flags,
HANDLE *redirectHandle
);
パラメーター
providerGuid
プロバイダー GUID。
flags
予約済み。 0 に設定します。
redirectHandle
ハンドルを受け取る変数へのポインター。
戻り値
FwpsRedirectHandleCreate0 関数は、次の NTSTATUS コードのいずれかを返します。
| リターン コード | 説明 |
|---|---|
|
リダイレクト ハンドルが正常に返されました。 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 |