AuditSetGlobalSaclA-Funktion (ntsecapi.h)

Artikel
02/29/2024

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

Syntax

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

Parameter

[in] ObjectTypeName

Ein Zeiger auf eine NULL-beendete 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" festgelegt werden, und zum Festlegen der globalen SACL für die Registrierung sollte dies 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, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. 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 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 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