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

Статья
11/20/2024

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

Синтаксис

BOOLEAN AuditQueryGlobalSaclA(
  [in]  PCSTR ObjectTypeName,
  [out] PACL  *Acl
);

Параметры

[in] ObjectTypeName

Указатель на строку, завершающуюся значением NULL, указывающую тип доступа к объекту. Этот параметр должен иметь значение "File" или "Key", в зависимости от того, является ли объект файлом или реестром. Эта строка отображается в любом сообщении аудита, которое создает функция.

[out] Acl

Указатель на структуру ACL, содержащую сведения об SACL. Это необходимо освободить позже, вызвав функцию LocalFree.

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 R2 [только классические приложения]
целевая платформа	Виндоус
заголовка	ntsecapi.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll

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