GetSecurityDescriptorOwner-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die GetSecurityDescriptorOwner-Funktion ruft die Besitzerinformationen aus einem Sicherheitsdeskriptor ab.

Syntax

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

Parameter

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , deren Besitzerinformationen die Funktion abruft.

[out] pOwner

Ein Zeiger auf einen Zeiger auf eine Sicherheits-ID (SID), die den Besitzer identifiziert, wenn die Funktion zurückgegeben wird. Wenn der Sicherheitsdeskriptor keinen Besitzer enthält, legt die Funktion den Zeiger, auf den pOwner zeigt, auf NULL fest und ignoriert den verbleibenden Ausgabeparameter lpbOwnerDefaulted. Wenn der Sicherheitsdeskriptor einen Besitzer enthält, legt die Funktion den Zeiger, auf den pOwner verweist, auf die Adresse der Besitzer-SID des Sicherheitsdeskriptors fest und stellt einen gültigen Wert für die Variable bereit, auf die von lpbOwnerDefaulted verwiesen wird.

[out] lpbOwnerDefaulted

Ein Zeiger auf ein Flag, das auf den Wert des SE_OWNER_DEFAULTED-Flags in der SECURITY_DESCRIPTOR_CONTROL-Struktur festgelegt wird, wenn die Funktion zurückgibt. Wenn der Wert, der in der Variablen gespeichert ist, auf die der pOwner-Parameter verweist, NULL ist, wird kein Wert festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
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ßen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll