通过

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）
库 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FwpsNetBufferListAssociateContext0 FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST