GetSecurityDescriptorOwner-Funktion (securitybaseapi.h)
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 |