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 |