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

Метод SetSecurity предоставляет дескриптор безопасности , содержащий сведения о безопасности, которые пользователь хочет применить к защищаемому объекту. Редактор управления доступом вызывает этот метод, когда пользователь нажимает кнопку ОК или Применить.

Синтаксис

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Параметры

[in] SecurityInformation

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

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

[in] pSecurityDescriptor

Указатель на дескриптор безопасности, содержащий новые сведения о безопасности. Не предполагайте, что дескриптор безопасности находится в самооблагаемой форме; Она может быть абсолютной или относительной.

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

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

При возникновении ошибки возвращает ненулевой код ошибки.

Комментарии

Чтобы создать полный дескриптор безопасности для объекта , приложение должно объединить новые части дескриптора безопасности, определенные параметром SecurityInformation , в существующий дескриптор безопасности объекта.

Требования

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

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

Редактор контроль доступа

Функции редактора контроль доступа

ISecurityInformation

SECURITY_INFORMATION