CreatePrivateObjectSecurity 函数 (securitybaseapi.h)

项目
03/05/2024

CreatePrivateObjectSecurity 函数为新的私有对象分配和初始化自相对安全描述符。受保护的服务器在创建新的私有对象时调用此函数。

若要指定新对象的对象类型 GUID 或控制如何继承访问控制项 (ACE) ，请使用 CreatePrivateObjectSecurityEx 函数。

语法

BOOL CreatePrivateObjectSecurity(
  [in, optional] PSECURITY_DESCRIPTOR ParentDescriptor,
  [in, optional] PSECURITY_DESCRIPTOR CreatorDescriptor,
  [out]          PSECURITY_DESCRIPTOR *NewDescriptor,
  [in]           BOOL                 IsDirectoryObject,
  [in, optional] HANDLE               Token,
  [in]           PGENERIC_MAPPING     GenericMapping
);

参数

[in, optional] ParentDescriptor

指向在其中创建新对象的父目录的安全描述符的指针。如果没有父目录，此参数可以为 NULL。

[in, optional] CreatorDescriptor

指向对象创建者提供的安全描述符的指针。如果对象的创建者未显式传递新对象的安全信息，则此参数应为 NULL。

[out] NewDescriptor

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

[in] IsDirectoryObject

指定新对象是否为容器。值为 TRUE 表示对象包含其他对象，例如目录。

[in, optional] Token

代表其创建对象的客户端进程的访问令牌的句柄。如果这是模拟令牌，则它必须处于 SecurityIdentification 级别或更高级别。有关 SecurityIdentification 模拟级别的完整说明，请参阅 SECURITY_IMPERSONATION_LEVEL 枚举类型。

客户端令牌用于检索新对象的默认安全信息，例如其默认所有者、主组和自由访问控制列表。令牌必须打开才能 TOKEN_QUERY 访问。

如果以下所有条件都为 true，则除了 TOKEN_QUERY 访问外，还必须打开句柄以 TOKEN_DUPLICATE 访问。

令牌句柄是指主令牌。
令牌的安全描述符包含一个或多个具有 OwnerRights SID 的 ACE。
为 CreatorDescriptor 参数指定安全描述符。
此函数的调用方不会在 AutoInheritFlags 参数中设置SEF_AVOID_OWNER_RESTRICTION标志。

[in] GenericMapping

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

返回值

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

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

注解

如果在 CreatorDescriptor 参数指定的SECURITY_DESCRIPTOR中指定了 SACL) (系统访问控制列表，则 Token 参数必须启用SE_SECURITY_NAME特权。 CreatePrivateObjectSecurity 函数会检查此权限，并可能在过程中生成审核。

要求

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