Метод ISecurityInformation::GetAccessRights (aclui.h)

Статья
02/28/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 соответствует члену InheritedObjectType объекта ACE.

[in] dwFlags

Набор битовых флагов, указывающих инициализируемые страницы свойств. Это значение равно нулю, если выполняется инициализация базовой страницы безопасности. В противном случае это сочетание следующих значений.

Значение	Значение
SI_ADVANCED	Страница свойств Advanced Security инициализируется.
SI_EDIT_AUDITS	Страница свойств Advanced Security содержит страницу свойств Аудит .
SI_EDIT_PROPERTIES	На странице свойств Advanced Security можно редактировать ACE, которые применяются к свойствам и наборам свойств объекта .

[out] ppAccess

Указатель на массив SI_ACCESS структур. Массив должен содержать одну запись для каждого права доступа. Вы можете указать права доступа, которые применяются к самому объекту, а также права доступа к конкретному объекту, которые применяются только к набору свойств или свойству объекта.

[out] pcAccesses

Указатель на ULONG , указывающий количество записей в массиве ppAccess .

[out] piDefaultAccess

Указатель на ULONG , указывающий отсчитываемый от нуля индекс элемента массива, содержащий права доступа по умолчанию. Редактор управления доступом использует эту запись в качестве начальных прав доступа в новом ACE.

Возвращаемое значение

Если функция выполнена успешно, функция возвращает S_OK.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	aclui.h