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

Статья
08/22/2023

Функция CreateSecurityPage создает базовую страницу свойств безопасности , которая позволяет пользователю просматривать и изменять права доступа, разрешенные или запрещенные записями управления доступом (ACE) в списке управления доступом (DACL) объекта. Используйте функцию PropertySheet или сообщение PSM_ADDPAGE , чтобы добавить эту страницу на страницу свойств.

Синтаксис

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

Параметры

[in] psi

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

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

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

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

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

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

Требования

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