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

Функция AuditSetPerUserPolicy задает политику аудита для каждого пользователя в одной или нескольких подкатегорий аудита для указанного субъекта.

Синтаксис

BOOLEAN AuditSetPerUserPolicy(
  [in] const PSID                 pSid,
  [in] PCAUDIT_POLICY_INFORMATION pAuditPolicy,
  [in] ULONG                      dwPolicyCount
);

Параметры

[in] pSid

Указатель на структуру идентификатора безопасности , связанную с субъектом, для которого настраивается политика аудита. Политика на пользователя для групповых идентификаторов БЕЗОПАСНОСТИ в настоящее время не поддерживается.

[in] pAuditPolicy

Указатель на массив AUDIT_POLICY_INFORMATION структур. Каждая структура определяет политику аудита для каждого пользователя для одной подкатегории аудита.

Элемент AuditCategoryGuid этих структур игнорируется.

[in] dwPolicyCount

Количество элементов в массиве pAuditPolicy .

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

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

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

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

Комментарии

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

Требования

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

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

AuditQueryPerUserPolicy

AuditQuerySystemPolicy

AuditSetSystemPolicy