Méthode ISecurityInformation ::GetSecurity (aclui.h)

Article
03/14/2023

La méthode GetSecurity demande un descripteur de sécurité pour l’objet sécurisable dont le descripteur de sécurité est en cours de modification. L’éditeur de contrôle d’accès appelle cette méthode pour récupérer le descripteur de sécurité actuel ou par défaut de l’objet.

Syntaxe

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

Paramètres

[in] RequestedInformation

Ensemble d’indicateurs de bits SECURITY_INFORMATION qui indiquent les parties du descripteur de sécurité demandées. Ce paramètre peut être une combinaison des valeurs suivantes.

Valeur	Signification
OWNER_SECURITY_INFORMATION	Le descripteur de sécurité doit inclure le SID du propriétaire de l’objet.
GROUP_SECURITY_INFORMATION	Le descripteur de sécurité doit inclure le SID du groupe principal de l’objet.
DACL_SECURITY_INFORMATION	Le descripteur de sécurité doit inclure la liste DACL de l’objet.
SACL_SECURITY_INFORMATION	Le descripteur de sécurité doit inclure la liste SACL de l’objet.

[out] ppSecurityDescriptor

Pointeur vers une variable que votre implémentation doit définir sur un pointeur vers le descripteur de sécurité de l’objet. Le descripteur de sécurité doit inclure les composants demandés par le paramètre RequestedInformation .

Le système appelle la fonction LocalFree pour libérer le pointeur retourné.

[in] fDefault

Si ce paramètre a la valeur TRUE, ppSecurityDescriptor doit retourner un descripteur de sécurité par défaut défini par l’application pour l’objet. L’éditeur de contrôle d’accès utilise ce descripteur de sécurité par défaut pour réinitialiser la page de propriétés.

L’éditeur de contrôle d’accès définit ce paramètre sur TRUE uniquement si l’utilisateur clique sur le bouton Par défaut . Le bouton Default s’affiche uniquement si vous définissez l’indicateur SI_RESET dans la méthode ISecurityInformation ::GetObjectInformation . Si aucun descripteur de sécurité par défaut n’est disponible, ne définissez pas l’indicateur SI_RESET.

Si cet indicateur a la valeur FALSE, ppSecurityDescriptor doit retourner le descripteur de sécurité actuel de l’objet.

Valeur retournée

Retourne S_OK en cas de réussite.

Retourne un code d’erreur différent de zéro si une erreur se produit. Retourne E_ACCESSDENIED si l’utilisateur n’a pas l’autorisation de lire les informations de sécurité demandées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	aclui.h