RegistrySecurity.AuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags) RegistrySecurity.AuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags) RegistrySecurity.AuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags) Method

Définition

Crée une règle d'audit, en spécifiant l'utilisateur auquel elle s'applique, les droits d'accès à auditer, l'héritage et la propagation de la règle, ainsi que le résultat qui déclenche la règle.Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, the inheritance and propagation of the rule, and the outcome that triggers the rule.

public:
 override System::Security::AccessControl::AuditRule ^ AuditRuleFactory(System::Security::Principal::IdentityReference ^ identityReference, int accessMask, bool isInherited, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);
public override System.Security.AccessControl.AuditRule AuditRuleFactory (System.Security.Principal.IdentityReference identityReference, int accessMask, bool isInherited, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);
override this.AuditRuleFactory : System.Security.Principal.IdentityReference * int * bool * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.AuditRule

Paramètres

identityReference
IdentityReference 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 Int32 Int32

Combinaison d'opérations de bits de valeurs RegistryRights spécifiant les droits d'accès à auditer, castés en entier.A bitwise combination of RegistryRights values specifying the access rights to audit, cast to an integer.

isInherited
Boolean Boolean 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 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 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.

flags
AuditFlags AuditFlags AuditFlags

Combinaison d'opérations de bits de valeurs AuditFlags spécifiant s'il faut auditer les accès réussis, les échecs d'accès ou les deux.A bitwise combination of AuditFlags values specifying whether to audit successful access, failed access, or both.

Retours

Objet RegistryAuditRule représentant la règle d'audit spécifiée, pour l'utilisateur spécifié, avec les indicateurs spécifiés.A RegistryAuditRule object representing the specified audit rule for the specified user, with the specified flags. Le type de retour de la méthode est la classe de base, AuditRule, mais la valeur de retour peut être castée sans risque en classe dérivée.The return type of the method is the base class, AuditRule, but the return value can be cast safely to the derived class.

Exceptions

accessMask, inheritanceFlags, propagationFlags ou flags spécifie une valeur non valide.accessMask, inheritanceFlags, propagationFlags, or flags 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 d’audit consiste à utiliser les constructeurs de la RegistryAuditRule classe.The recommended way to create audit rules is to use the constructors of the RegistryAuditRule class.

Notes

Bien que vous puissiez spécifier le InheritanceFlags.ObjectInherit indicateur, il est inutile lors de cette opération.Although you can specify the InheritanceFlags.ObjectInherit flag, there is no point in doing so. Dans le cadre du contrôle d’audit, les paires nom/valeur dans une sous-clé ne sont pas des objets distincts.For the purposes of audit control, the name/value pairs in a subkey are not separate objects. Les droits d’audit pour les paires nom/valeur sont contrôlés par les droits de la sous-clé.The audit 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 (autrement dit, ils peuvent contenir d’autres sous-clés), elles ne sont pas affectées par la ObjectInherit indicateur.Furthermore, since all subkeys are containers (that is, they can contain other subkeys), they are not affected by the ObjectInherit flag. Enfin, en spécifiant le ObjectInherit indicateur complique inutilement la maintenance des règles, car il 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 à