FwpmConnectionSetSecurityInfo0 函数 (fwpmu.h)
FwpmConnectionSetSecurityInfo0 函数在连接对象更改事件的安全描述符中设置指定的安全信息。
语法
DWORD FwpmConnectionSetSecurityInfo0(
[in] HANDLE engineHandle,
[in] SECURITY_INFORMATION securityInfo,
[in, optional] const SID *sidOwner,
[in, optional] const SID *sidGroup,
[in, optional] const ACL *dacl,
[in, optional] const ACL *sacl
);
参数
[in] engineHandle
类型: 句柄
筛选器引擎的打开会话的句柄。 调用 FwpmEngineOpen0 以打开与筛选器引擎的会话。
[in] securityInfo
要设置的安全信息的类型。
[in, optional] sidOwner
类型: const SID*
所有者的安全标识符 (SID) 在安全描述符中设置。
[in, optional] sidGroup
类型: const SID*
在安全描述符中设置组的 SID。
[in, optional] dacl
类型: const ACL*
(DACL) 安全描述符中设置的任意访问控制列表。
[in, optional] sacl
类型: const ACL*
系统访问控制列表 (SACL) 在安全描述符中设置。
返回值
类型:DWORD
返回代码/值 | 说明 |
---|---|
|
已成功设置安全信息。 |
|
Windows 筛选平台 (WFP) 特定错误。 有关详细信息 ,请参阅 WFP 错误代码 。 |
|
无法与远程或本地防火墙引擎通信。 |
备注
不能从事务内部调用此函数。 它将失败并 出现FWP_E_TXN_IN_PROGRESS。 有关事务的详细信息,请参阅 对象管理 。
不能从动态会话中调用此函数。 它将失败并 出现FWP_E_DYNAMIC_SESSION_IN_PROGRESS。 有关会话的详细信息,请参阅 对象管理 。
此函数的行为类似于标准 Win32 SetSecurityInfo 函数。 调用方需要与 SetSecurityInfo 参考主题中所述相同的标准访问权限。
要求
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | fwpmu.h |
Library | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |