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


AtlSetSacl

Эта функция вызывается, чтобы задать данные системного списка управления доступом (sacl) указанного объекта.

Важно!

Эту функцию нельзя использовать в приложениях, выполняемых в Среда выполнения Windows.

inline bool AtlSetSacl( 
HANDLE hObject, 
SE_OBJECT_TYPE ObjectType, 
const CSacl& rSacl, 
DWORD dwInheritanceFlowControl= 0, 
bool bRequestNeededPrivileges= true 
) throw(...);

Параметры

  • hObject
    Дескриптор объекта, для которого устанавливаются сведения о безопасности.

  • ObjectType
    Задает значение из перечисления SE_OBJECT_TYPE, которое указывает тип объекта, заданный параметром hObject.

  • rSacl
    Системный список управления доступом, содержащий новую сведения о безопасности.

  • dwInheritanceFlowControl
    Управление потоком наследования. Это значение может быть равно 0 (по умолчанию), PROTECTED_SACL_SECURITY_INFORMATION или UNPROTECTED_SACL_SECURITY_INFORMATION.

  • bRequestNeededPrivileges
    True, если функция будет пытаться включить права SE_SECURITY_NAME, и извлекает его при завершении.

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

Возвращает значение true, если операция выполнена успешно; в противном случае — значение false.

Заметки

В отладочные построения, произойдет ошибка утверждения если hObject недопустимо или если dwInheritanceFlowControl не является одним из 3, разрешенных значений.

Если AtlSetSacl вызываться несколько раз во многих различных объектов, оно будет более эффективным включение привилегию SE_SECURITY_NAME один раз до вызова функции с bRequestNeededPrivileges установлено в значение false.

Требования

Header: atlsecurity.h

См. также

Ссылки

AtlGetSacl

CSacl Class

Другие ресурсы

Security Global Functions