Функция 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.
| Возвращаемый код или значение | Описание |
|---|---|
|
Вызывающий объект не имеет прав доступа, необходимых для вызова этой функции. |
|
Один или несколько параметров недопустимы. |
|
Структура sid, указанная параметром pSID , не связана с существующим пользователем. |
Комментарии
Чтобы успешно вызвать эту функцию, вызывающий объект должен иметь SeSecurityPrivilege или AUDIT_SET_USER_POLICY доступ к объекту безопасности Audit.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | ntsecapi.h |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |