Compartilhar via


Função AuditEnumerateSubCategories (ntsecapi.h)

A função AuditEnumerateSubCategories enumera as subcategorias de política de auditoria disponíveis.

Sintaxe

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

Parâmetros

[in] pAuditCategoryGuid

O GUID de uma categoria de política de auditoria para a qual as subcategorias são enumeradas. Se o valor do parâmetro bRetrieveAllSubCategories for TRUE, esse parâmetro será ignorado.

[in] bRetrieveAllSubCategories

TRUE para enumerar todas as subcategorias de política de auditoria; FALSE para enumerar apenas as subcategorias da categoria audit-policy especificada pelo parâmetro pAuditCategoryGuid .

[out] ppAuditSubCategoriesArray

Um ponteiro para um único buffer que contém uma matriz de ponteiros para estruturas GUID e as estruturas em si. As estruturas GUID especificam as subcategorias de política de auditoria disponíveis no computador.

Quando terminar de usar esse buffer, libere-o chamando a função AuditFree .

[out] pdwCountReturned

Um ponteiro para o número de subcategorias de política de auditoria retornadas na matriz ppAuditSubCategoriesArray .

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

AuditEnumerateCategories