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

Статья
08/22/2023

Метод GetSecurity запрашивает дескриптор безопасности для защищаемого объекта, дескриптор безопасности которого редактируется. Редактор управления доступом вызывает этот метод, чтобы получить текущий дескриптор безопасности объекта или дескриптор безопасности по умолчанию.

Синтаксис

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

Параметры

[in] RequestedInformation

Набор SECURITY_INFORMATION битовых флагов, указывающих части запрашиваемого дескриптора безопасности. Этот параметр может быть сочетанием следующих значений.

Значение	Значение
OWNER_SECURITY_INFORMATION	Дескриптор безопасности должен содержать идентификатор безопасности владельца объекта.
GROUP_SECURITY_INFORMATION	Дескриптор безопасности должен содержать идентификатор безопасности основной группы объекта.
DACL_SECURITY_INFORMATION	Дескриптор безопасности должен содержать daCL объекта.
SACL_SECURITY_INFORMATION	Дескриптор безопасности должен содержать saCL объекта.

[out] ppSecurityDescriptor

Указатель на переменную, которую реализация должна задать в качестве указателя на дескриптор безопасности объекта. Дескриптор безопасности должен включать компоненты, запрашиваемые параметром RequestedInformation .

Система вызывает функцию LocalFree, чтобы освободить возвращенный указатель.

[in] fDefault

Если этот параметр имеет значение TRUE, ppSecurityDescriptor должен возвращать определенный приложением дескриптор безопасности по умолчанию для объекта . Редактор управления доступом использует этот дескриптор безопасности по умолчанию для повторной инициализации страницы свойств.

Редактор управления доступом устанавливает для этого параметра значение TRUE , только если пользователь нажимает кнопку По умолчанию . Кнопка По умолчанию отображается только в том случае, если вы установили флаг SI_RESET в методе ISecurityInformation::GetObjectInformation . Если дескриптор безопасности по умолчанию недоступен, не устанавливайте флаг SI_RESET.

Если этот флаг имеет значение FALSE, ppSecurityDescriptor должен возвращать текущий дескриптор безопасности объекта.

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

В случае успешного выполнения возвращает S_OK.

При возникновении ошибки возвращает ненулевой код ошибки. Возвращает E_ACCESSDENIED, если у пользователя нет разрешения на чтение запрошенных сведений о безопасности.

Требования

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