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

Функция AuditSetGlobalSaclA (ntsecapi.h)

  • Статья

Функция AuditSetGlobalSacl задает глобальный системный список управления доступом (SACL), который делегирует доступ к сообщениям аудита. Для обновления глобального списка SACL требуется SeSecurityPrivilege , который защищает глобальный список управления доступом к файлу от обновления любым пользователем без прав администратора.

Синтаксис

BOOLEAN AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] PACL  Acl
);

Параметры

[in] ObjectTypeName

Указатель на строку со значением NULL, указывающую тип создаваемого или доступного объекта. Для задания глобального списка SACL для файлов необходимо задать значение "Файл", а для параметра глобального списка saCL в реестре — значение "Ключ". Эта строка отображается в любом сообщении аудита, которое создает функция.

[in, optional] Acl

Указатель на структуру ACL .

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

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

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

Возвращаемый код или значение Описание
ERROR_ACCESS_DENIED
5
 Вызывающий объект не имеет прав доступа, необходимых для вызова этой функции.
ERROR_INVALID_PARAMETER
87
 Один или несколько параметров недопустимы.

Комментарии

Чтобы успешно вызвать эту функцию, вызывающий объект должен иметь SeSecurityPrivilege.

Примечание

Заголовок ntsecapi.h определяет AuditSetGlobalSacl в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
Библиотека Advapi32.lib
DLL Advapi32.dll