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

Статья
11/20/2024

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

Синтаксис

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntsecapi.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll

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