通过

FwpmDynamicKeywordSubscribe0 函数 (fwpmu.h)

  • 项目

请求传送有关特定动态关键字 (keyword) 地址 (FW_DYNAMIC_KEYWORD_ADDRESS0) 对象的更改的通知。 根据传入的标志，只能针对一部分地址引发通知。

有关详细信息和代码示例，请参阅 防火墙动态关键字。

语法

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

参数

flags

类型：_In_ DWORD

以下标志在 中 fwpmu.h定义。

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE 指示仅针对设置了 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 标志的对象传递通知。

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE 指示仅针对 未 设置 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 标志的对象传递通知。

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE指示将针对所有动态关键字 (keyword) 地址对象传递通知。

callback

类型：_In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

指向你实现的回调函数的指针，该函数将在通知准备好传递时调用。

context

类型：_In_opt_ void*

一个可选的上下文指针。 此指针将传递给回调函数。

subscriptionHandle

类型：_Out_ HANDLE*

句柄的地址，用新创建的订阅的句柄填充。

返回值

类型： DWORD

如果函数成功，则返回 ERROR_SUCCESS。 否则，它将返回以下值之一。

返回值 说明
ERROR_INVALID_PARAMETER 标志值为零。

注解

添加或删除对象时，将传递有关 AutoResolve 动态关键字 (keyword) 地址的通知。

添加、删除或更新对象时，会传递非自动解决动态关键字 (keyword) 地址的通知。

未向回调函数提供任何数据。 如果需要有关系统上已更改的内容的信息，可以使用 枚举 API。

当你不再需要订阅时，你负责关闭句柄。 必须通过调用 FwpmDynamicKeywordUnsubscribe0 函数来执行此操作。

FWPM_DYNAMIC_KEYWORD_CALLBACK0的实现应快速响应动态关键字 (keyword) 寻址对象中的更改，因为它在 ThreadPool 线程上计划，并可能影响其他等待操作。

要求

要求 值
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
目标平台 Windows
标头 fwpmu.h
Library Fwpuclnt.lib
DLL Fwpuclnt.dll

另请参阅