Partager via

Méthode IAccessControl ::GrantAccessRights (iaccess.h)

  • Article

Fusionne la nouvelle liste de droits d’accès avec les droits d’accès existants sur l’objet .

Syntaxe

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

Paramètres

[in] pAccessList

Pointeur vers la structure ACTRL_ACCESS qui contient un tableau de listes d’accès pour l’objet .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La fusion de la nouvelle liste de droits d’accès avec les droits d’accès existants garantit que l’objet aura au moins les droits d’accès indiqués. Ce processus de fusion consiste à ajouter les nouveaux droits d’accès refusés avant les anciens droits d’accès refusés et les nouveaux droits d’accès autorisés avant les droits autorisés existants. Aucun des droits existants n’est supprimé.

Après une fusion, les droits d’accès sur un objet sont classés comme suit :

  1. [Nouvel accès refusé]
  2. [Ancien accès refusé]
  3. [Nouvel accès autorisé]
  4. [Ancien accès autorisé]
Implémentation fournie par le système de [ACTRL_ACCESS](.. La structure /accctrl/ns-accctrl-explicit_access_a.md) doit être définie sur 1. En outre, le membre lpProperty de la structure ACTRL_PROPERTY_ENTRYW doit être NULL pour indiquer que la liste d’entrées d’accès s’applique à l’objet lui-même.

Configuration requise

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

Voir aussi

IAccessControl