netfw.h) (PFN_FWADDDYNAMICKEYWORDADDRESS0 回调函数
调用的服务中用于添加指定动态关键字 (keyword) 地址的入口点的函数指针类型。
注意
此免费函数的指针类型通过 NetFw.h发布，但不会发布静态链接库。 使用 LoadLibraryExW/GetProcAddress 模式调用此函数。
调用 GetProcAddress 时，将句柄传递给 firewallapi.dll 模块，并将 FWAddDynamicKeywordAddress0 作为 lpProcName 参数传递。
有关详细信息和代码示例，请参阅 防火墙动态关键字。
语法
PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;
DWORD PfnFwadddynamickeywordaddress0(
const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}
parameters
dynamicKeywordAddress
类型： const PFW_DYNAMIC_KEYWORD_ADDRESS0
指向常量 (填充) 动态关键字 (keyword) 地址对象的指针。
返回值
类型： DWORD
如果函数成功 (成功创建对象并将其添加到) ，则返回 ERROR_SUCCESS。 否则，它将返回以下值之一。
| 返回值 | 说明 |
|---|---|
| ERROR_ACCESS_DENIED | 调用方没有创建此对象的适当权限。 |
| ERROR_ALREADY_EXISTS | 系统上已存在具有指定 ID 的对象。 |
| ERROR_INVALID_PARAMETER | FW_DYNAMIC_KEYWORD_ADDRESS0无效。 有关有效用法 ，请参阅备注 。 |
注解
- 如果设置了 FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE 标志，则：
- 地址必须为 NULL，并且
- 关键字 (keyword) 字段应是可以解析的字符串;即 FQDN 或主机名。
- 如果未设置FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE标志，则地址字段必须是以逗号分隔的 IP 地址令牌列表。 令牌可以是单个 IP 地址、范围或子网。 有效的令牌格式包括：
- 有效的 IPv4 地址 (，例如 10.0.0.10)
- 有效的 IPv6 地址 (，例如 2620：1ec：c11：：200)
- 格式为 <开始>地址结束<地址>的 IPv4 地址范围， (不包含空格，例如 10.0.0.0-10.0.0.255)
- 格式为开始地址>-<结束地址>的 <IPv6 地址范围， (不包含空格，例如 2001：db8：abcd：12：：-2001：db8：abcd：12：ffff：ffff：ffff：ffff)
- 使用网络前缀表示法指定的有效 IPv4 子网， (例如 10.0.0.0/24)
- 使用前缀长度表示法 (指定的有效 IPv6 子网，例如 2001：db8：abcd：0012：：0/64)
- 一个动态关键字 (keyword) 地址在重新启动后会一直存在。 对于 AutoResolved 对象，地址 不会 在启动周期中保留，必须在以下启动周期期间重新评估。
要求
| 最低受支持的客户端 | Windows 10内部版本 20348 |
| 最低受支持的服务器 | Windows 10内部版本 20348 |
| 目标平台 | Windows |
| 标头 | netfw.h |
| DLL | firewallapi.dll |