AuditLookupCategoryNameA-Funktion (ntsecapi.h)

  • Artikel

Die AuditLookupCategoryName-Funktion ruft den Anzeigenamen der angegebenen Überwachungsrichtlinienkategorie ab.

Syntax

BOOLEAN AuditLookupCategoryNameA(
  [in]  const GUID *pAuditCategoryGuid,
  [out] PSTR       *ppszCategoryName
);

Parameter

[in] pAuditCategoryGuid

Ein Zeiger auf eine GUID-Struktur , die eine Überwachungsrichtlinienkategorie angibt.

[out] ppszCategoryName

Die Adresse eines Zeigers auf eine null-beendete Zeichenfolge, die den Anzeigenamen der audit-policy-Kategorie enthält, die von der pAuditCategoryGuid-Funktion angegeben wird.

Wenn Sie die Verwendung dieser Zeichenfolge abgeschlossen haben, geben Sie sie frei, indem Sie die AuditFree-Funktion aufrufen.

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.

Hinweise

Hinweis

Der ntsecapi.h-Header definiert AuditLookupCategoryName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

AuditLookupSubCategoryName