RtlGetOwnerSecurityDescriptor-Funktion (ntifs.h)

Artikel
03/05/2024

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 die Sicherheitsbeschreibung.

[out] Owner

Zeiger auf eine Adresse, um einen Zeiger auf die Besitzersicherheits-ID (SID) zu erhalten. Wenn der Sicherheitsdeskriptor derzeit keine Besitzer-SID enthält, erhält Der BesitzerNULL.

[out] OwnerDefaulted

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

Rückgabewert

RtlGetOwnerSecurityDescriptor gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

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

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
Unterstützte Mindestversion (Client)	Windows 2000
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	PASSIVE_LEVEL