Функция EditSecurity (aclui.h)

Статья
02/23/2024

Функция EditSecurity отображает страницу свойств, содержащую базовую страницу свойств безопасности. Эта страница свойств позволяет пользователю просматривать и изменять права доступа, разрешенные или запрещенные ACE в DACL объекта.

Синтаксис

BOOL ACLUIAPI EditSecurity(
  [in] HWND           hwndOwner,
  [in] LPSECURITYINFO psi
);

Параметры

[in] hwndOwner

Дескриптор для окна, которому принадлежит страница свойств. Этот параметр может принимать значение NULL.

[in] psi

Указатель на реализацию интерфейса ISecurityInformation . Система вызывает методы интерфейса для получения сведений об редактируемом объекте и возврата входных данных пользователя.

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

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

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Во время инициализации страницы свойств система вызывает методы ISecurityInformation::GetSecurity и ISecurityInformation::SetSecurity , чтобы определить, имеет ли пользователь разрешение на изменение дескриптора безопасности объекта. Система отображает сообщение об ошибке, если у пользователя нет разрешения.

Страница базовых свойств безопасности может содержать кнопку Дополнительно для отображения страницы расширенных свойств безопасности. Эта страница свойств расширенной безопасности может содержать три дополнительные страницы свойств, которые позволяют пользователю просматривать и изменять DACL, SACL и владельца объекта.

Требования

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