AuditSetGlobalSaclW-Funktion (ntsecapi.h)

Artikel
02/29/2024

Die AuditSetGlobalSacl-Funktion legt eine globale Systemzugriffssteuerungsliste (SACL) fest, 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 AuditSetGlobalSaclW(
  [in]           PCWSTR ObjectTypeName,
  [in, optional] PACL   Acl
);

Parameter

[in] ObjectTypeName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Typ des Objekts angibt, auf das erstellt oder zugegriffen wird. 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 Überwachungsmeldung angezeigt, die von der Funktion generiert wird.

[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. 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 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
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