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 |