Freigeben über


AuditLookupCategoryNameA-Funktion (ntsecapi.h)

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 mit Null beendete Zeichenfolge, die den Anzeigenamen der überwachungsrichtlinienkategorie enthält, die durch die pAuditCategoryGuid-Funktion angegeben wird.

Wenn Sie diese Zeichenfolge verwendet haben, geben Sie sie frei, indem Sie die funktion AuditFree aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE-zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE-zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der ntsecapi.h-Header definiert AuditLookupCategoryName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- ntsecapi.h
Library Advapi32.lib
DLL- Advapi32.dll

Siehe auch

AuditLookupSubCategoryName