IAccessControl：：GetAllAccessRights 方法 (iaccess.h)

  • 项目

获取指定对象的访问权限和/或所有者和组的完整列表。

语法

HRESULT GetAllAccessRights(
  [in]  LPWSTR                            lpProperty,
  [out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
  [out] PTRUSTEEW                         *ppOwner,
  [out] PTRUSTEEW                         *ppGroup
);

参数

[in] lpProperty

属性的名称。 如果使用 IAccessControl 的 COM 实现，则此参数必须为 NULL。

[out] ppAccessList

接收指向访问列表结构的指针的指针变量的地址。 不能 ACTRL_ACCESS此参数。

如果调用成功，调用方必须使用 CoTaskMemFree 函数释放分配的内存。 请注意，内存 (all_nodes) 分配，这意味着所有子结构都分配在一个块中。 因此，整个数据结构必须通过对 CoTaskMemFree 的单个调用来释放。

[out] ppOwner

指向接收所有者信息的 TRUSTEE 结构的指针。 如果此参数不为 NULL 且函数成功，则调用方必须使用 CoTaskMemFree 释放内存。

[out] ppGroup

指向接收组信息的 TRUSTEE 结构的指针。 如果此参数不为 NULL 且函数成功，则调用方必须使用 CoTaskMemFree 释放内存。

返回值

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

要求

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

另请参阅

ACTRL_ACCESS

IAccessControl