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

  • Статья

Функция AuditQuerySecurity извлекает дескриптор безопасности , который делегирует доступ к политике аудита.

Синтаксис

BOOLEAN AuditQuerySecurity(
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor
);

Параметры

[in] SecurityInformation

Значение SECURITY_INFORMATION , указывающее, какие части дескриптора безопасности задается этой функцией. Поддерживаются только SACL_SECURITY_INFORMATION и DACL_SECURITY_INFORMATION . Все остальные значения игнорируются. Если ни SACL_SECURITY_INFORMATION , ни DACL_SECURITY_INFORMATION не указаны, эта функция завершается сбоем и возвращает ERROR_INVALID_PARAMETER.

[out] ppSecurityDescriptor

Адрес указателя на правильно сформированную структуру SECURITY_DESCRIPTOR , которая управляет доступом к объекту безопасности Audit.

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

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

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

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

Комментарии

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

Требования

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

См. также раздел

AuditSetSecurity