RegistrySecurity.AuditRuleFactory Méthode

Définition

Espace de noms:

System.Security.AccessControl

Assembly:

Microsoft.Win32.Registry.dll

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.

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

Public Overrides Function AuditRuleFactory (identityReference As IdentityReference, accessMask As Integer, isInherited As Boolean, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags) As AuditRule

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 spécifiant les droits d'accès à auditer, 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.

flags

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.

Retours

AuditRule

Objet RegistryAuditRule représentant la règle d'audit spécifiée, pour l'utilisateur spécifié, avec les indicateurs spécifiés. 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.

Exceptions

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlags ou flags 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 d’audit consiste à utiliser les constructeurs de la RegistryAuditRule classe .

Notes

Bien que vous puissiez spécifier l’indicateur InheritanceFlags.ObjectInherit , cela ne sert à rien. Pour les besoins du contrôle d’audit, les paires nom/valeur dans une sous-clé ne sont pas des objets distincts. Les droits d’audit sur les 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 (c’est-à-dire qu’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.