RegistrySecurity.AccessRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AccessControlType) Méthode

Définition

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.Creates a new access control rule for the specified user, with the specified access rights, access control, and flags.

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

Paramètres

identityReference
IdentityReference

IdentityReference qui identifie l'utilisateur ou le groupe auquel s'applique la règle.An IdentityReference that identifies the user or group the rule applies to.

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.A bitwise combination of RegistryRights values specifying the access rights to allow or deny, cast to an integer.

isInherited
Boolean

Valeur booléenne spécifiant si la règle est héritée.A Boolean value specifying whether the rule is inherited.

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.A bitwise combination of InheritanceFlags values specifying how the rule is inherited by subkeys.

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.A bitwise combination of PropagationFlags values that modify the way the rule is inherited by subkeys. Sans utilité si la valeur de inheritanceFlags est None.Meaningless if the value of inheritanceFlags is None.

type
AccessControlType

Une des valeurs AccessControlType spécifiant si les droits sont accordés ou refusés.One of the AccessControlType values specifying whether the rights are allowed or denied.

Retours

Objet RegistryAccessRule représentant les droits spécifiés pour l'utilisateur spécifié.A RegistryAccessRule object representing the specified rights for the specified user.

Exceptions

accessMask, inheritanceFlags, propagationFlags ou type spécifie une valeur non valide.accessMask, inheritanceFlags, propagationFlags, or type specifies an invalid value.

identityReference est null.identityReference is null.

- ou --or- accessMask est égal à zéro.accessMask is zero.

identityReference n'est ni du type SecurityIdentifier, ni d'un type tel que NTAccount qui peut être converti en type SecurityIdentifier.identityReference is neither of type SecurityIdentifier, nor of a type such as NTAccount that can be converted to type SecurityIdentifier.

Remarques

La méthode recommandée pour créer des règles de contrôle d’accès consiste à utiliser les constructeurs RegistryAccessRule de la classe.The recommended way to create access control rules is to use the constructors of the RegistryAccessRule class.

Notes

Bien que vous puissiez spécifier InheritanceFlags.ObjectInherit l’indicateur, ce n’est pas le cas.Although you can specify the InheritanceFlags.ObjectInherit flag, there is no point in doing so. Dans le cadre du contrôle d’accès, les paires nom/valeur d’une sous-clé ne sont pas des objets distincts.For the purposes of access control, the name/value pairs in a subkey are not separate objects. Les droits d’accès aux paires nom/valeur sont contrôlés par les droits de la sous-clé.The access rights to name/value pairs are controlled by the rights of the subkey. En outre, étant donné que toutes les sous-clés sont des conteneurs (c’est-à-dire qu’elles peuvent contenir d’autres sous-clés) ObjectInherit , elles ne sont pas affectées par l’indicateur.Furthermore, since all subkeys are containers (that is, they can contain other subkeys), they are not affected by the ObjectInherit flag. Enfin, la spécification ObjectInherit de l’indicateur complique inutilement la maintenance des règles, car elle interfère avec la combinaison normale de règles compatibles.Finally, specifying the ObjectInherit flag needlessly complicates the maintenance of rules, because it interferes with the normal combination of compatible rules.

S’applique à