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

  • Статья

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

Синтаксис

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Параметры

[in] SecurityInformation

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

[in] pSecurityDescriptor

Указатель на правильно сформированную SECURITY_DESCRIPTOR структуру, которая управляет доступом к объекту безопасности Audit. Если этот параметр имеет значение NULL, функция завершается ошибкой и возвращает ERROR_INVALID_PARAMETER.

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

Если функция выполняется успешно, возвращается значение 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

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

AuditQuerySecurity