Expand Minimize

AuditEnumerateSubCategories function

The AuditEnumerateSubCategories function enumerates the available audit-policy subcategories.

Syntax


BOOLEAN WINAPI AuditEnumerateSubCategories(
  _In_   const GUID *pAuditCategoryGuid,
  _In_   BOOLEAN bRetrieveAllSubCategories,
  _Out_  GUID **ppAuditSubCategoriesArray,
  _Out_  PULONG pCountReturned
);

Parameters

pAuditCategoryGuid [in]

The GUID of an audit-policy category for which subcategories are enumerated. If the value of the bRetrieveAllSubCategories parameter is TRUE, this parameter is ignored.

bRetrieveAllSubCategories [in]

TRUE to enumerate all audit-policy subcategories; FALSE to enumerate only the subcategories of the audit-policy category specified by the pAuditCategoryGuid parameter.

ppAuditSubCategoriesArray [out]

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 subcategories available on the computer.

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

pCountReturned [out]

A pointer to the number of audit-policy subcategories returned in the ppAuditSubCategoriesArray array.

Return value

If the function succeeds, it returns TRUE.

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Ntsecapi.h

Library

Advapi32.lib

DLL

Advapi32.dll

See also

AuditEnumerateCategories

 

 

Community Additions

ADD
Show:
© 2014 Microsoft