FwpsAcquireClassifyHandle0 函数（fwpsk.h）

FwpsAcquireClassifyHandle0 函数生成一个分类句柄，该句柄用于标识异步分类作和对可写层数据的请求。

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

语法

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

[in] classifyContext

来自 classifyFn1的 classifyContext 参数。 WFP 引擎将此值传递给标注驱动程序的分类Fn。

[in] flags

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

[out] classifyHandle

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

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

返回代码	描述
STATUS_SUCCESS	已成功返回分类请求的句柄。 classifyHandle 参数指向的变量，该变量包含分类请求的句柄。
其他状态代码	发生错误。

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

对于此函数的每个调用，标注驱动程序必须调用 FwpsReleaseClassifyHandle0 来释放与句柄关联的系统资源。