SetSecurityDescriptorOwner-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die SetSecurityDescriptorOwner-Funktion legt die Besitzerinformationen eines absoluten Sicherheitsdeskriptors fest. Es ersetzt alle Besitzerinformationen, die bereits in der Sicherheitsbeschreibung vorhanden sind.

Syntax

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Parameter

[in, out] pSecurityDescriptor

Ein Zeiger auf die SECURITY_DESCRIPTOR-Struktur , deren Besitzer von dieser Funktion festgelegt wird. Die Funktion ersetzt jeden vorhandenen Besitzer durch den neuen Besitzer.

[in, optional] pOwner

Ein Zeiger auf eine SID-Struktur für den neuen primären Besitzer des Sicherheitsdeskriptors. Auf die SID-Struktur wird vom Sicherheitsdeskriptor verwiesen, nicht in diese kopiert. Wenn dieser Parameter NULL ist, löscht die Funktion die Besitzerinformationen des Sicherheitsdeskriptors. Dadurch wird der Sicherheitsdeskriptor als ohne Besitzer gekennzeichnet.

[in] bOwnerDefaulted

Gibt an, ob die Besitzerinformationen von einem Standardmechanismus abgeleitet werden. Wenn dieser Wert TRUE ist, handelt es sich um Standardinformationen. Die Funktion speichert diesen Wert als SE_OWNER_DEFAULTED Flag in der SECURITY_DESCRIPTOR_CONTROL-Struktur . Wenn dieser Parameter 0 ist, wird das flag SE_OWNER_DEFAULTED gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll