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

Функция AuditQuerySystemPolicy извлекает политику аудита системы для одной или нескольких подкатегорий политики аудита.

Синтаксис

BOOLEAN AuditQuerySystemPolicy(
  [in]  const GUID                *pSubCategoryGuids,
  [in]  ULONG                     dwPolicyCount,
  [out] PAUDIT_POLICY_INFORMATION *ppAuditPolicy
);

Параметры

[in] pSubCategoryGuids

Указатель на массив значений GUID , указывающих подкатегории, для которых запрашивает политику аудита. Список определенных подкатегорий политики аудита см. в разделе Константы аудита.

[in] dwPolicyCount

Количество элементов в каждом массиве pSubCategoryGuids и ppAuditPolicy .

[out] ppAuditPolicy

Указатель на один буфер, содержащий как массив указателей на AUDIT_POLICY_INFORMATION структуры, так и сами структуры. Структуры AUDIT_POLICY_INFORMATION указывают политику аудита системы для подкатегорий, указанных массивом pSubCategoryGuids .

Завершив использование этого буфера, освободите его, вызвав функцию AuditFree .

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

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

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

Комментарии

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

Требования