RtlCreateSecurityDescriptorRelative-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlCreateSecurityDescriptorRelative Routine initialisiert einen neuen Sicherheitsdeskriptor im selbstrelativen Format. Bei Rückgabe wird der Sicherheitsdeskriptor ohne System-ACL (SACL), keine diskretionäre ACL (DACL), kein Besitzer, keine primäre Gruppe und alle Steuerelementkennzeichnungen auf Null initialisiert.

Syntax

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Parameter

[out] SecurityDescriptor

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, der mindestens Größe von(SECURITY_DESCRIPTOR_RELATIVE) sein muss, um den initialisierten Sicherheitsdeskriptor zu empfangen.

[in] Revision

Revisionsebene, die dem Sicherheitsdeskriptor zugewiesen werden soll. Dieser Parameter muss SECURITY_DESCRIPTOR_REVISION werden.

Rückgabewert

RtlCreateSecurityDescriptorRelative kann eine der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Anruf wurde erfolgreich abgeschlossen.
STATUS_UNKNOWN_REVISION	Die angegebene Revision ist nicht bekannt oder wird nicht unterstützt.

Bemerkungen

Tatsächlich initialisiert ein erfolgreicher Aufruf dieser Routine einen Sicherheitsdeskriptor ohne Sicherheitseinschränkungen.

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 2000
Zielplattform-	Desktop
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	PASSIVE_LEVEL