RtlSetOwnerSecurityDescriptor-Funktion (ntifs.h)

Artikel
02/07/2025

Der RtlSetOwnerSecurityDescriptor Routine legt die Besitzerinformationen eines Absolutformat-Sicherheitsdeskriptors fest. Er 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

Zeigen Sie auf die SECURITY_DESCRIPTOR Struktur, deren Besitzer festgelegt werden soll. RtlSetOwnerSecurityDescriptor ersetzt alle vorhandenen Besitzer durch den neuen Besitzer.

[in, optional] Owner

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

[in, optional] OwnerDefaulted

Legen Sie auf TRUE fest, wenn die Besitzerinformationen von einem Standardmechanismus abgeleitet werden. Wenn dieser Wert TRUEist, 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 SE_OWNER_DEFAULTED Flag gelöscht.

Rückgabewert

RtlSetOwnerSecurityDescriptor kann einen der folgenden Statuscodes 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.

Bemerkungen

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
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL-	< DISPATCH_LEVEL