AuditEnumerateSubCategories-Funktion (ntsecapi.h)

Die Funktion AuditEnumerateSubCategories listet die verfügbaren Audit-Policy-Unterkategorien auf.

Syntax

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

Parameter

[in] pAuditCategoryGuid

Die GUID einer Überwachungsrichtlinienkategorie, für die Unterkategorien aufgelistet werden. Wenn der Wert des bRetrieveAllSubCategories-ParametersTRUE ist, wird dieser Parameter ignoriert.

[in] bRetrieveAllSubCategories

TRUE , um alle Überwachungsrichtlinienunterkategorien aufzulisten; FALSE , um nur die Unterkategorien der audit-policy-Kategorie aufzulisten, die durch den pAuditCategoryGuid-Parameter angegeben sind.

[out] ppAuditSubCategoriesArray

Ein Zeiger auf einen einzelnen Puffer, der sowohl ein Array von Zeigern auf GUID-Strukturen als auch die Strukturen selbst enthält. Die GUID-Strukturen geben die Überwachungsrichtlinienunterkategorien an, die auf dem Computer verfügbar sind.

Wenn Sie mit der Verwendung dieses Puffers fertig sind, geben Sie ihn frei, indem Sie die AuditFree-Funktion aufrufen.

[out] pdwCountReturned

Ein Zeiger auf die Anzahl der überwachungsrichtlinienunterkategorien, die im ppAuditSubCategoriesArray-Array zurückgegeben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

AuditEnumerateCategories