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) connect 重定向标注可以将连接重定向到本地进程之前，它必须使用 FwpsRedirectHandleCreate0 函数获取重定向句柄，并将该句柄置于 FWPS_CONNECT_REQUEST0 结构中。标注修改 ALE 连接重定向层的分类Fn 中的结构。

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