Función AuditEnumerateSubCategories (ntsecapi.h)

La función AuditEnumerateSubCategories enumera las subcategorías de directiva de auditoría disponibles.

Sintaxis

BOOLEAN AuditEnumerateSubCategories(
  [in]  const GUID *pAuditCategoryGuid,
  [in]  BOOLEAN    bRetrieveAllSubCategories,
  [out] GUID       **ppAuditSubCategoriesArray,
  [out] PULONG     pdwCountReturned
);

Parámetros

[in] pAuditCategoryGuid

GUID de una categoría de directiva de auditoría para la que se enumeran las subcategorías. Si el valor del parámetro bRetrieveAllSubCategories es TRUE, este parámetro se omite.

[in] bRetrieveAllSubCategories

TRUE para enumerar todas las subcategorías de directiva de auditoría; FALSE para enumerar solo las subcategorías de la categoría audit-policy especificadas por el parámetro pAuditCategoryGuid .

[out] ppAuditSubCategoriesArray

Puntero a un único búfer que contiene una matriz de punteros a estructuras GUID y a las propias estructuras. Las estructuras GUID especifican las subcategorías de directiva de auditoría disponibles en el equipo.

Cuando haya terminado de usar este búfer, libere este búfer llamando a la función AuditFree .

[out] pdwCountReturned

Puntero al número de subcategorías de directiva de auditoría devueltas en la matriz ppAuditSubCategoriesArray .

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Consulte también

AuditEnumerateCategories