FwpsvSwitchEventsSubscribe0 函数 (fwpsk.h)

  • 项目

FwpsvSwitchEventsSubscribe0 函数为虚拟交换机层事件（例如虚拟端口创建和删除）注册回调入口点。

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

 

语法

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

参数

providerGuid

提供程序 GUID。

notifyContext

指向标注驱动程序提供的上下文的可选指针。 事件通知函数将此参数传递回驱动程序。

flags

保留。 设置为零。

reserved

保留。 设置为零。

eventDispatchTable

指向 FWPS_VSWITCH_EVENT_DISPATCH_TABLE 结构的指针，该结构定义虚拟交换机层事件的回调入口点。

subscriptionId

指向变量的指针，该变量包含 WFP 分配给订阅的唯一标识符。 调用方必须使用 FwpsvSwitchEventsUnsubscribe0 函数将订阅标识符返回到 WFP。

返回值

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

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

注解

标注驱动程序调用 FwpsvSwitchEventsSubscribe0 函数来注册虚拟交换机层事件的回调入口点。

回调通知函数的入口点在 和 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 结构中指定。

标注驱动程序稍后必须调用 FwpsvSwitchEventsUnsubscribe0 以释放系统资源。

要求

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

另请参阅

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0