RtlGetOwnerSecurityDescriptor-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlGetOwnerSecurityDescriptor Routine gibt die Besitzerinformationen für einen bestimmten Sicherheitsdeskriptor zurück.

Syntax

NTSYSAPI NTSTATUS RtlGetOwnerSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Owner,
  [out] PBOOLEAN             OwnerDefaulted
);

Parameter

[in] SecurityDescriptor

Zeiger auf den Sicherheitsdeskriptor.

[out] Owner

Zeigen Sie auf eine Adresse, um einen Zeiger auf den Sicherheitsbezeichner des Besitzers zu erhalten (SID). Wenn der Sicherheitsdeskriptor derzeit keine Besitzer-SID enthält, empfängt OwnerNULL-.

[out] OwnerDefaulted

Zeiger auf eine boolesche Variable, die TRUE empfängt, wenn die Besitzerinformationen von einem Standardmechanismus abgeleitet werden, anstatt vom ursprünglichen Anbieter des Sicherheitsdeskriptors explizit, FALSE andernfalls. Nur gültig, wenn Owner einen Wert ohneNULL erhält.

Rückgabewert

RtlGetOwnerSecurityDescriptor gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert wie einen der folgenden zurück:

Rückgabecode	Beschreibung
STATUS_UNKNOWN_REVISION	Die Revisionsebene des Sicherheitsdeskriptors ist nicht bekannt oder wird nicht unterstützt. Dies ist ein Fehlercode.

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
mindestens unterstützte Client-	Windows 2000
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL-	PASSIVE_LEVEL