RtlSetOwnerSecurityDescriptor-Funktion (ntifs.h)

Artikel
02/26/2024

Die RtlSetOwnerSecurityDescriptor-Routine legt die Besitzerinformationen eines absoluten Sicherheitsdeskriptors fest. Sie ersetzt alle Besitzerinformationen, die bereits im Sicherheitsdeskriptor vorhanden sind.

Syntax

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Parameter

[in, out] SecurityDescriptor

Zeiger auf die SECURITY_DESCRIPTOR-Struktur, deren Besitzer festgelegt werden soll. RtlSetOwnerSecurityDescriptor ersetzt jeden vorhandenen Besitzer durch den neuen Besitzer.

[in, optional] Owner

Zeiger auf eine Sicherheitsbezeichnerstruktur (Security Identifier, SID) für den neuen primären Besitzer des Sicherheitsdeskriptors. Dieser Zeiger, nicht die SID-Struktur selbst, wird in die Sicherheitsbeschreibung kopiert. Wenn dieser Parameter NULL ist, löscht RtlSetOwnerSecurityDescriptor die Besitzerinformationen des Sicherheitsdeskriptors. Dadurch wird der Sicherheitsdeskriptor als ohne Besitzer gekennzeichnet.

[in, optional] OwnerDefaulted

Legen Sie auf TRUE fest, wenn die Besitzerinformationen von einem Standardmechanismus abgeleitet werden. Wenn dieser Wert TRUE ist, handelt es sich um Standardinformationen. RtlSetOwnerSecurityDescriptor legt das SE_OWNER_DEFAULTED-Flag im Feld SECURITY_DESCRIPTOR_CONTROL des Sicherheitsdeskriptors fest. Wenn dieser Parameter FALSE ist, wird das flag SE_OWNER_DEFAULTED deaktiviert.

Rückgabewert

RtlSetOwnerSecurityDescriptor kann einen der folgenden status-Codes zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Besitzer wurde erfolgreich festgelegt oder zurückgesetzt.
STATUS_UNKNOWN_REVISION	Die Version des angegebenen Sicherheitsdeskriptors wird von dieser Routine nicht erkannt.
STATUS_INVALID_SECURITY_DESCR	Der angegebene Sicherheitsdeskriptor ist kein gültiger absoluter Sicherheitsdeskriptor.

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
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	< DISPATCH_LEVEL