Метод IAccessControl::GetAllAccessRights (iaccess.h)

Статья
02/26/2024

Возвращает полный список прав доступа и (или) владельца и группы для указанного объекта.

Синтаксис

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

Параметры

[in] lpProperty

Имя свойства. Если вы используете com-реализацию IAccessControl, этот параметр должен иметь значение 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
Header	iaccess.h

См. также раздел

ACTRL_ACCESS

IAccessControl

Поделиться через