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 |