RegistrySecurity.AccessRuleFactory Méthode

Définition

Espace de noms:

System.Security.AccessControl

Assembly:

Microsoft.Win32.Registry.dll

Crée une règle de contrôle d'accès pour l'utilisateur spécifié, avec les droits d'accès, le contrôle d'accès et les indicateurs spécifiés.

public:
 override System::Security::AccessControl::AccessRule ^ AccessRuleFactory(System::Security::Principal::IdentityReference ^ identityReference, int accessMask, bool isInherited, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public override System.Security.AccessControl.AccessRule AccessRuleFactory (System.Security.Principal.IdentityReference identityReference, int accessMask, bool isInherited, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

override this.AccessRuleFactory : System.Security.Principal.IdentityReference * int * bool * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.AccessRule

Public Overrides Function AccessRuleFactory (identityReference As IdentityReference, accessMask As Integer, isInherited As Boolean, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType) As AccessRule

Paramètres

identityReference

IdentityReference

IdentityReference qui identifie l'utilisateur ou le groupe auquel s'applique la règle.

accessMask

Int32

Combinaison d'opérations de bits de valeurs RegistryRights qui spécifient les droits d'accès à accorder ou refuser, castés en entier.

isInherited

Boolean

Valeur booléenne spécifiant si la règle est héritée.

inheritanceFlags

InheritanceFlags

Combinaison d'opérations de bits de valeurs InheritanceFlags spécifiant la façon dont les sous-clés héritent de la règle.

propagationFlags

PropagationFlags

Combinaison d'opérations de bits de valeurs PropagationFlags qui modifient la façon dont les sous-clés héritent de la règle. Sans utilité si la valeur de inheritanceFlags est None.

type

AccessControlType

Une des valeurs AccessControlType spécifiant si les droits sont accordés ou refusés.

Retours

AccessRule

Objet RegistryAccessRule représentant les droits spécifiés pour l'utilisateur spécifié.

Exceptions

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlags ou type spécifie une valeur non valide.

ArgumentNullException

identityReference a la valeur null.

- ou -

accessMask est égal à zéro.

ArgumentException

identityReference n'est ni du type SecurityIdentifier, ni d'un type tel que NTAccount qui peut être converti en type SecurityIdentifier.

Remarques

La méthode recommandée pour créer des règles de contrôle d’accès consiste à utiliser les constructeurs de la RegistryAccessRule classe .

Notes

Bien que vous puissiez spécifier l’indicateur InheritanceFlags.ObjectInherit , il est inutile de le faire. Aux fins du contrôle d’accès, les paires nom/valeur d’une sous-clé ne sont pas des objets distincts. Les droits d’accès aux paires nom/valeur sont contrôlés par les droits de la sous-clé. En outre, étant donné que toutes les sous-clés sont des conteneurs (autrement dit, elles peuvent contenir d’autres sous-clés), elles ne sont pas affectées par l’indicateur ObjectInherit . Enfin, la spécification de l’indicateur ObjectInherit complique inutilement la maintenance des règles, car elle interfère avec la combinaison normale de règles compatibles.