MutexSecurity.AuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags) Méthode

Définition

Crée une règle d'audit, en spécifiant l'utilisateur auquel elle s'applique, les droits d'accès à auditer et le résultat qui déclenche la règle d'audit.Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, and the outcome that triggers the audit 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 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 MutexRights spécifiant les droits d'accès à auditer, castés en entier.A bitwise combination of MutexRights values specifying the access rights to audit, cast to an integer.

isInherited
Boolean

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.Meaningless for named wait handles, because they have no hierarchy.

inheritanceFlags
InheritanceFlags

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.Meaningless for named wait handles, because they have no hierarchy.

propagationFlags
PropagationFlags

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.Meaningless for named wait handles, because they have no hierarchy.

flags
AuditFlags

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

Retours

Objet MutexAuditRule représentant la règle d'audit spécifiée pour l'utilisateur spécifié.A MutexAuditRule object representing the specified audit rule for the specified user. 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 a la valeur 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 MutexAuditRule la classe.The recommended way to create audit rules is to use the constructors of the MutexAuditRule class.

Notes

Bien que les indicateurs d’héritage et de propagation soient sans utilité pour les mutex nommés, il est toujours possible de les spécifier.Although inheritance and propagation flags are meaningless for named mutexes, it is still possible to specify them. Cela n’est pas recommandé, car il complique inutilement la maintenance des règles, par exemple en interférant avec la combinaison de règles qui seraient autrement compatibles.This is not recommended, because it needlessly complicates the maintenance of rules, for example by interfering with the combination of rules that would otherwise be compatible.

S’applique à