ConvertToAutoInheritPrivateObjectSecurity 函数 (securitybaseapi.h)

项目
03/01/2024

ConvertToAutoInheritPrivateObjectSecurity 函数将安全描述符及其访问控制列表 (ACL) 转换为支持自动传播可继承访问控制项 (ACE) 的格式。

语法

BOOL ConvertToAutoInheritPrivateObjectSecurity(
  [in, optional] PSECURITY_DESCRIPTOR ParentDescriptor,
  [in]           PSECURITY_DESCRIPTOR CurrentSecurityDescriptor,
  [out]          PSECURITY_DESCRIPTOR *NewSecurityDescriptor,
  [in, optional] GUID                 *ObjectType,
  [in]           BOOLEAN              IsDirectoryObject,
  [in]           PGENERIC_MAPPING     GenericMapping
);

参数

[in, optional] ParentDescriptor

指向对象的父容器的安全描述符的指针。如果没有父容器，则此参数为 NULL。

[in] CurrentSecurityDescriptor

指向对象的当前安全描述符的指针。

[out] NewSecurityDescriptor

指向变量的指针，该变量接收指向新分配的自相对安全描述符的指针。调用方负责调用 DestroyPrivateObjectSecurity 函数来释放此安全描述符。

[in, optional] ObjectType

指向 GUID 结构的指针，该结构标识与 CurrentSecurityDescriptor 参数关联的对象类型。如果对象没有 GUID，则此参数必须为 NULL。

[in] IsDirectoryObject

如果 为 TRUE，则新对象是容器，可以包含其他对象。如果 为 FALSE，则新对象不是容器。

[in] GenericMapping

指向 GENERIC_MAPPING 结构的指针，该结构指定从每个泛型权限到对象特定权限的映射。

返回值

如果函数成功，该函数将返回非零值。

如果函数失败，则返回零。要获得更多的错误信息，请调用 GetLastError。

注解

ConvertToAutoInheritPrivateObjectSecurity 函数尝试确定是否从父安全描述符的 SACL) 继承 (DACL) 和系统访问控制列表中的 ACE (SACL) 。函数将 ParentDescriptor 参数传递给 CreatePrivateObjectSecurityEx 函数，以获取仅包含继承 ACE 的 ACL。然后，它将这些 ACE 与原始安全描述符中的 ACE 进行比较，以确定继承了哪些原始 ACE。 ACE 不需要一对一匹配。例如，允许对受托人进行读写访问的 ACE 可以等效于两个 ACE：允许读取访问的 ACE 和允许写入访问的 ACE。

原始安全描述符中与从父安全描述符继承的 ACE 等效的任何 ACE 都标有INHERITED_ACE标志，并添加到新的安全描述符中。原始安全描述符中的所有其他 ACE 都作为非遗传 ACE 添加到新的安全描述符中。

如果原始 DACL 没有任何继承的 ACE，则函数在新的安全描述符的控制位中设置SE_DACL_PROTECTED标志。同样，如果未继承 SACL 中的 ACE，则设置SE_SACL_PROTECTED标志。

对于继承 ACE 的 ACL，函数将 ACE 重新排序为两组。第一个组具有直接应用于对象的 ACE。第二个组继承了 ACE。此排序可确保非继承 ACE 优先于继承的 ACE。有关详细信息，请参阅 DACL 中 ACE 的顺序。

函数在新安全描述符的控制位中设置SE_DACL_AUTO_INHERITED和SE_SACL_AUTO_INHERITED标志。

函数不会更改允许访问 ACE 相对于 DACL 中拒绝访问的 ACE 的顺序，因为这样做会更改生成的安全描述符的语义。如果函数无法在不更改语义的情况下转换 DACL，则它将 DACL 保持不变，并设置SE_DACL_PROTECTED标志。

新的安全描述符具有与原始安全描述符相同的所有者和主组。

新的安全描述符等效于原始安全描述符，因此调用方无需任何访问权限或特权，也可以将安全描述符更新为新格式。

此函数适用于 ACL_REVISION 和 ACL_REVISION_DS ACL。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	securitybaseapi.h (包括 Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll