RtlGetSaclSecurityDescriptor-Funktion (ntifs.h)

Artikel
02/07/2025

Der RtlGetSaclSecurityDescriptor Routine gibt einen Zeiger auf die System-ACL (SACL) für einen Sicherheitsdeskriptor zurück.

Syntax

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

Parameter

[in] SecurityDescriptor

Zeiger auf die SECURITY_DESCRIPTOR, deren SACL zurückgegeben werden soll.

[out] SaclPresent

Zeiger auf eine boolesche Variable, die das Vorhandensein einer SACL im angegebenen Sicherheitsdeskriptor angibt. Wenn diese Variable TRUEempfängt, enthält der Sicherheitsdeskriptor eine SACL, und die verbleibenden Ausgabeparameter erhalten gültige Werte. Wenn diese Variable FALSEempfängt, enthält der Sicherheitsdeskriptor keine SACL, und die verbleibenden Ausgabeparameter erhalten keine gültigen Werte.

[out] Sacl

Zeiger auf eine Variable, die die Adresse der SACL für die Sicherheitsbeschreibung empfängt. Wenn der Sicherheitsdeskriptor über keine SACL verfügt, erhält diese Variable keinen Wert. Wenn der Sicherheitsdeskriptor über einen NULL- SACL verfügt, empfängt diese Variable NULL-.

[out] SaclDefaulted

Zeiger auf eine boolesche Variable, die den Wert des SE_SACL_DEFAULTED Flags in der SECURITY_DESCRIPTOR_CONTROL Struktur des Sicherheitsdeskriptors empfängt, wenn eine SACL für den Sicherheitsdeskriptor vorhanden ist.

Rückgabewert

RtlGetSaclSecurityDescriptor gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie den folgenden zurück:

Rückgabecode	Beschreibung
STATUS_UNKNOWN_REVISION	Die Revisionsebene des Sicherheitsdeskriptors ist unbekannt oder wird nicht unterstützt. Dies ist ein Fehlercode.

Bemerkungen

Weitere Informationen zur Sicherheits- und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und die Dokumentation zu diesen Themen im Windows SDK.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Server 2003 SP1
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL