ISecurityInformation：：GetAccessRights 方法 (aclui.h)

项目
03/13/2024

GetAccessRights 方法请求有关可为安全对象控制的访问权限的信息。访问控制编辑器调用此方法以检索用于初始化属性页的显示字符串和其他信息。有关详细信息，请参阅访问权限和访问掩码。

语法

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

参数

[in] pguidObjectType

指向 GUID 结构的指针，该结构标识为其请求访问权限的对象的类型。如果此参数为 NULL 或指向GUID_NULL的指针，则返回正在编辑的对象的访问权限。否则，GUID 标识由 ISecurityInformation：：GetInheritTypes 方法返回的子对象类型。 GUID 对应于特定于对象的 ACE 的 InheritedObjectType 成员。

[in] dwFlags

一组指示正在初始化的属性页的位标志。如果正在初始化基本安全页，则此值为零。否则，它是以下值的组合。

值	含义
SI_ADVANCED	正在初始化高级安全属性表。
SI_EDIT_AUDITS	“ 高级安全性” 属性表包含 “审核 ”属性页。
SI_EDIT_PROPERTIES	高级安全性属性表允许编辑应用于对象的属性和属性集的 ACE。

[out] ppAccess

指向SI_ACCESS结构的数组的指针。对于每个访问权限，数组必须包含一个条目。可以指定应用于对象本身的访问权限，以及仅适用于对象上的属性集或属性的特定于对象的访问权限。

[out] pcAccesses

指向 ULONG 的指针，指示 ppAccess 数组中的条目数。

[out] piDefaultAccess

指向 ULONG 的指针，指示包含默认访问权限的数组项的从零开始的索引。访问控制编辑器使用此项作为新 ACE 中的初始访问权限。

返回值

如果函数成功，该函数将返回S_OK。

如果函数失败，它将返回指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅常见 HRESULT 值。

注解

每次初始化属性页时都会调用 GetAccessRights 方法。

访问控制编辑器不会释放 ppAccess 中返回的指针。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	aclui.h