FwpsAcquireClassifyHandle0 函数 (fwpsk.h)

FwpsAcquireClassifyHandle0 函数生成分类句柄,用于标识异步分类操作和可写层数据请求。

注意FwpsAcquireClassifyHandle0FwpsAcquireClassifyHandle 的特定版本。 有关详细信息 ,请参阅 WFP Version-Independent 名称和面向特定版本的 Windows
 

语法

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

参数

[in] classifyContext

classifyFn1 中的 classifyContext 参数。 WFP 引擎将此值传递给标注驱动程序的 classifyFn

[in] flags

保留供将来使用。 设置为 0。

[out] classifyHandle

指向接收分类句柄的变量的指针。 如备注中所述,后续函数调用需要此句柄。

返回值

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

返回代码 说明
STATUS_SUCCESS
已成功返回分类请求的句柄。 classifyHandle 参数指向的变量包含分类请求的句柄。
其他状态代码
出现了错误。

注解

FwpsAcquireClassifyHandle0 是异步分类和数据修改的支持函数。 需要此函数返回的句柄作为以下函数的参数:

每次调用此函数时,标注驱动程序都必须调用 FwpsReleaseClassifyHandle0 以释放与句柄关联的系统资源。

要求

要求
最低受支持的客户端 从 Windows 7 开始可用。
目标平台 通用
标头 fwpsk.h (包括 Fwpsk.h)
Library Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1