RtlGetSaclSecurityDescriptor-Funktion (ntifs.h)

Artikel
02/29/2024

Die 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 TRUE empfängt, enthält der Sicherheitsdeskriptor eine SACL, und die verbleibenden Ausgabeparameter erhalten gültige Werte. Wenn diese Variable FALSE empfä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 den Sicherheitsdeskriptor empfängt. Wenn der Sicherheitsdeskriptor über keine SACL verfügt, erhält diese Variable keinen Wert. Wenn der Sicherheitsdeskriptor über eine 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.

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Server 2003 SP1
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL