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


Метод 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. Кроме того, член lpProperty структуры ACTRL_PROPERTY_ENTRYW должен иметь значение NULL , чтобы указать, что список записей доступа применяется к самому объекту.

Требования

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

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

IAccessControl