IAccessControl::GrantAccessRights 方法 (iaccess.h)

将新访问权限列表与对象上的现有访问权限合并。

语法

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

参数

[in] pAccessList

指向 ACTRL_ACCESS 结构的指针,该结构包含对象的访问列表数组。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

将新访问权限列表与现有访问权限合并可确保对象至少具有指示的访问权限。 此合并过程包括在旧的拒绝访问权限之前添加新的拒绝访问权限,在现有允许的权限之前添加新的允许访问权限。 不会删除任何现有权限。

合并后,对象的访问权限按如下顺序排序:

  1. [拒绝新访问]
  2. [旧访问被拒绝]
  3. [允许新访问]
  4. [允许旧访问]
系统提供的 [ACTRL_ACCESS] (.的实现。/accctrl/ns-accctrl-explicit_access_a.md) 结构设置为 1。 此外,ACTRL_PROPERTY_ENTRYW 结构的 lpProperty 成员必须为 NULL,以指示访问条目列表应用于对象本身。

要求

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

另请参阅

IAccessControl