Freigeben über


SetSecurityDescriptorOwner-Funktion (securitybaseapi.h)

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

Weitere Informationen

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorSacl