RtlCreateSecurityDescriptorRelative Funktion (ntifs.h)

Artikel
02/27/2024

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

Syntax

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

Parameter

[out] SecurityDescriptor

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der mindestens sizeof(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 Rückgaben zurückgeben:

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

Hinweise

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

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 2000
Zielplattform	Desktop
Kopfzeile	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL