AuditEnumerateSubCategories, fonction (ntsecapi.h)

La fonction AuditEnumerateSubCategories énumère les sous-catégories de stratégie d’audit disponibles.

Syntaxe

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

Paramètres

[in] pAuditCategoryGuid

GUID d’une catégorie de stratégie d’audit pour laquelle les sous-catégories sont énumérées. Si la valeur du paramètre bRetrieveAllSubCategories est TRUE, ce paramètre est ignoré.

[in] bRetrieveAllSubCategories

TRUE pour énumérer toutes les sous-catégories de stratégie d’audit ; FALSE pour énumérer uniquement les sous-catégories de la catégorie de stratégie d’audit spécifiée par le paramètre pAuditCategoryGuid .

[out] ppAuditSubCategoriesArray

Pointeur vers une mémoire tampon unique qui contient à la fois un tableau de pointeurs vers des structures GUID et les structures elles-mêmes. Les structures GUID spécifient les sous-catégories de stratégie d’audit disponibles sur l’ordinateur.

Lorsque vous avez terminé d’utiliser cette mémoire tampon, libérez-la en appelant la fonction AuditFree .

[out] pdwCountReturned

Pointeur vers le nombre de sous-catégories de stratégie d’audit retournées dans le tableau ppAuditSubCategoriesArray .

Valeur retournée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntsecapi.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

AuditEnumerateCategories