AuditQueryGlobalSaclA-Funktion (ntsecapi.h)

Artikel
08/08/2024

Die AuditQueryGlobalSacl-Funktion ruft eine globale Systemzugriffssteuerungsliste (SACL) ab, die den Zugriff auf die Überwachungsnachrichten delegiert. Zum Aktualisieren der globalen SACL ist das SeSecurityPrivilege erforderlich, das die globale SACL vor der Aktualisierung durch benutzerlose Administratorrechte schützt.

Syntax

BOOLEAN AuditQueryGlobalSaclA(
  [in]  PCSTR ObjectTypeName,
  [out] PACL  *Acl
);

Parameter

[in] ObjectTypeName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Typ des Objekts angibt, auf das zugegriffen wird. Dieser Parameter muss entweder "File" oder "Key" lauten, je nachdem, ob es sich bei dem Objekt um eine Datei oder eine Registrierung handelt. Diese Zeichenfolge wird in jeder Überwachungsmeldung angezeigt, die von der Funktion generiert wird.

[out] Acl

Ein Zeiger auf eine ACL-Struktur , die die SACL-Informationen enthält. Dies sollte später durch Aufrufen der LocalFree-Funktion freigegeben werden.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise einen der folgenden Fehlercodes zurück, die in WinError.h definiert sind.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_ACCESS_DENIED 5	Der Aufrufer verfügt nicht über die Berechtigungen oder Zugriffsrechte, die zum Aufrufen dieser Funktion erforderlich sind.
ERROR_INVALID_PARAMETER 87	Mindestens ein Parameter ist ungültig.

Hinweise

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer über SeSecurityPrivilege verfügen.

Hinweis

Der ntsecapi.h-Header definiert AuditQueryGlobalSacl 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
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecapi.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über