AuditEnumerateCategories function (ntsecapi.h)

The AuditEnumerateCategories function enumerates the available audit-policy categories.


BOOLEAN AuditEnumerateCategories(
  [out] GUID   **ppAuditCategoriesArray,
  [out] PULONG pdwCountReturned


[out] ppAuditCategoriesArray

A pointer to a single buffer that contains both an array of pointers to GUID structures and the structures themselves. The GUID structures specify the audit-policy categories available on the computer.

When you have finished using this buffer, free it by calling the AuditFree function.

[out] pdwCountReturned

A pointer to the number of elements in the ppAuditCategoriesArray array.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.


Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header ntsecapi.h
Library Advapi32.lib
DLL Advapi32.dll

See also