AuditSetGlobalSaclA-Funktion (ntsecapi.h)

Artikel
11/20/2024

Die AuditSetGlobalSacl--Funktion legt eine globale Systemzugriffssteuerungsliste (SACL) fest, die den Zugriff auf die Überwachungsmeldungen delegiert. Das Aktualisieren der globalen SACL erfordert die SeSecurityPrivilege-, die die globale SACL vor der Aktualisierung durch jeden Benutzer ohne Administratorrechte schützt.

Syntax

BOOLEAN AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] PACL  Acl
);

Parameter

[in] ObjectTypeName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Typ des zu erstellenden oder zugegriffenen Objekts angibt. Zum Festlegen der globalen SACL für Dateien sollte dies auf "Datei" und für das Festlegen der globalen SACL in der Registrierung auf "Schlüssel" festgelegt werden. Diese Zeichenfolge wird in jeder Von der Funktion generierten Überwachungsmeldung angezeigt.

[in, optional] Acl

Ein Zeiger auf eine ACL- Struktur.

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. GetLastError- kann einen der folgenden Fehlercodes zurückgeben, die in WinError.h definiert sind.

Zurückgeben von Code/Wert	Beschreibung
ERROR_ACCESS_DENIED 5	Der Aufrufer verfügt nicht über die zum Aufrufen dieser Funktion erforderlichen Berechtigungen oder Zugriffsrechte.
ERROR_INVALID_PARAMETER 87	Mindestens ein Parameter ist ungültig.

Bemerkungen

Um diese Funktion erfolgreich aufzurufen, muss der Aufrufer SeSecurityPrivilegehaben.

Anmerkung

Der ntsecapi.h-Header definiert AuditSetGlobalSacl 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 7 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	ntsecapi.h
Library	Advapi32.lib
DLL-	Advapi32.dll

Freigeben über