FwpsRedirectHandleCreate0 函数（fwpsk.h）

FwpsRedirectHandleCreate0 函数创建连接重定向函数可用于将连接重定向到本地进程的句柄。有关重定向的详细信息，请参阅使用绑定或连接重定向。

注释FwpsRedirectHandleCreate0 是 FwpsRedirectHandleCreate的特定版本。有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。

语法

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

providerGuid

提供程序 GUID。

flags

保留。设置为零。

redirectHandle

指向接收句柄的变量的指针。

FwpsRedirectHandleCreate0 函数返回以下 NTSTATUS 代码之一。

返回代码	描述
STATUS_SUCCESS	已成功返回重定向句柄。 redirectHandle 参数指向的包含句柄的变量。
其他状态代码	发生错误。

标注驱动程序调用 FwpsRedirectHandleCreate0 函数来创建可用于重定向连接的句柄。

有关重定向的详细信息，请参阅使用绑定或连接重定向。

标注驱动程序应调用 FwpsRedirectHandleCreate0 一次并缓存句柄，以便它可以重复使用句柄。

在应用程序层强制（ALE）连接重定向标注可以重定向到本地进程之前，它必须获取具有 FwpsRedirectHandleCreate0 函数的重定向句柄，并将句柄置于 FWPS_CONNECT_REQUEST0 结构中。标注修改 ALE 连接重定向层的分类Fn 中的结构。

调用驱动程序使用重定向句柄后，它必须调用 FwpsRedirectHandleDestroy0 函数来销毁句柄。