Partager via


Fonction SetSecurityDescriptorOwner (securitybaseapi.h)

La fonction SetSecurityDescriptorOwner définit les informations de propriétaire d’un descripteur de sécurité au format absolu. Il remplace toutes les informations de propriétaire déjà présentes dans le descripteur de sécurité.

Syntaxe

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Paramètres

[in, out] pSecurityDescriptor

Pointeur vers la structure SECURITY_DESCRIPTOR dont le propriétaire est défini par cette fonction. La fonction remplace tout propriétaire existant par le nouveau propriétaire.

[in, optional] pOwner

Pointeur vers une structure SID pour le nouveau propriétaire principal du descripteur de sécurité. La structure SID est référencée par, et non copiée dans, le descripteur de sécurité. Si ce paramètre a la valeur NULL, la fonction efface les informations de propriétaire du descripteur de sécurité. Cela marque le descripteur de sécurité comme n’ayant aucun propriétaire.

[in] bOwnerDefaulted

Indique si les informations de propriétaire sont dérivées d’un mécanisme par défaut. Si cette valeur est TRUE, il s’agit d’informations par défaut. La fonction stocke cette valeur en tant qu’indicateur SE_OWNER_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL . Si ce paramètre est égal à zéro, l’indicateur SE_OWNER_DEFAULTED est effacé.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Spécifications

   
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

Voir aussi

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

Access Control de bas niveau

Fonctions Access Control de bas niveau

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorSacl