GetSecurityDescriptorOwner, fonction (securitybaseapi.h)

Article
03/01/2024

La fonction GetSecurityDescriptorOwner récupère les informations de propriétaire à partir d’un descripteur de sécurité.

Syntaxe

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

Paramètres

[in] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR dont la fonction récupère les informations de propriétaire.

[out] pOwner

Pointeur vers un pointeur vers un identificateur de sécurité (SID) qui identifie le propriétaire lorsque la fonction retourne. Si le descripteur de sécurité ne contient pas de propriétaire, la fonction définit le pointeur pointeur vers pOwner sur NULL et ignore le paramètre de sortie restant, lpbOwnerDefaulted. Si le descripteur de sécurité contient un propriétaire, la fonction définit le pointeur vers lequel pOwner pointe vers l’adresse du SID du propriétaire du descripteur de sécurité et fournit une valeur valide pour la variable pointée par lpbOwnerDefaulted.

[out] lpbOwnerDefaulted

Pointeur vers un indicateur défini sur la valeur de l’indicateur SE_OWNER_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL lorsque la fonction retourne. Si la valeur stockée dans la variable pointée par le paramètre pOwner est NULL, aucune valeur n’est définie.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	securitybaseapi.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll