FwpsNetBufferListRetrieveContext0 函数 (fwpsk.h)

  • 项目

FwpsNetBufferListRetrieveContext0 函数检索与在另一层中标记的网络缓冲区列表关联的上下文。

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

语法

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

参数

[in, out] netBufferList

一个网络缓冲区列表，指示标注驱动程序感兴趣的一个或多个数据包。 如果设置了 removeContext ，则返回的网络缓冲区列表将删除上下文。

[in] contextTag

通过调用 获取的本地唯一标识符 FwpsNetBufferListGetTagForContext0 函数。 这是对 FwpsNetBufferListAssociateContext0 的初始调用中使用的上下文标记。

[in] removeContext

如果设置， FwpsNetBufferListRetrieveContext0 除了检索上下文外，还将删除上下文关联。

[in] flags

此参数保留供将来使用，并设置为零。

[out] context

在 FwpsNetBufferListAssociateContext0 的初始调用中由标注驱动程序分配给数据包的上下文。

返回值

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

返回代码 说明
STATUS_SUCCESS
 关联成功。
其他状态代码
 出现了错误。

注解

FwpsNetBufferListRetrieveContext0 函数检索在另一层中标记的网络缓冲区列表。

还可以使用此函数通过设置 removeContext 参数来删除上下文关联。

要求

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

另请参阅

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST