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

  • Статья

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

Синтаксис

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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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