RtlCreateSecurityDescriptor-Funktion (wdm.h)

Die RtlCreateSecurityDescriptor-Routine initialisiert einen neuen Absoluten-Format-Sicherheitsdeskriptor. Bei der Rückgabe wird die Sicherheitsbeschreibung ohne System-ACL, ohne diskretionäre ACL, ohne Besitzer, ohne primäre Gruppe und mit allen Steuerelementflags initialisiert, die auf 0 festgelegt sind.

Syntax

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  ULONG                Revision
);

Parameter

[out] SecurityDescriptor

Zeiger auf den Puffer für die zu initialisierende SECURITY_DESCRIPTOR.

[in] Revision

Gibt die Revisionsebene an, die dem Sicherheitsdeskriptor zugewiesen werden soll. Legen Sie diesen Parameter auf SECURITY_DESCRIPTOR_REVISION fest.

Rückgabewert

RtlCreateSecurityDescriptor kann eine der folgenden Elemente zurückgeben.

Rückgabecode Beschreibung
STATUS_SUCCESS
Der Aufruf wurde erfolgreich abgeschlossen.
STATUS_UNKNOWN_REVISION
Der Aufrufer hat einen nicht unterstützten Wert für Revision angegeben.

Hinweise

Ein erfolgreicher Aufruf dieser Routine initialisiert eine Sicherheitsbeschreibung. Die Felder in diesem Deskriptor sind auf Anfangswerte festgelegt, die angeben, dass es keine Sicherheitseinschränkungen gibt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL PASSIVE_LEVEL

Weitere Informationen

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR