MutexSecurity.AuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags) Metodo

Definizione

Crea una nuova regola di controllo che specifica l'utente a cui viene applicata la regola, i diritti di accesso da controllare e il risultato che attiva la regola di controllo.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

Parametri

identityReference
IdentityReference

Classe IdentityReference che identifica l'utente o il gruppo a cui viene applicata la regola.An IdentityReference that identifies the user or group the rule applies to.

accessMask
Int32

Combinazione bit per bit di valori MutexRights che specificano i diritti di accesso da controllare, per effettuare il cast in un intero.A bitwise combination of MutexRights values specifying the access rights to audit, cast to an integer.

isInherited
Boolean

Non significativo per gli handle di attesa denominati, perché non hanno gerarchia.Meaningless for named wait handles, because they have no hierarchy.

inheritanceFlags
InheritanceFlags

Non significativo per gli handle di attesa denominati, perché non hanno gerarchia.Meaningless for named wait handles, because they have no hierarchy.

propagationFlags
PropagationFlags

Non significativo per gli handle di attesa denominati, perché non hanno gerarchia.Meaningless for named wait handles, because they have no hierarchy.

flags
AuditFlags

Combinazione bit per bit di valori AuditFlags che specificano se controllare l'accesso riuscito, l'accesso non riuscito o entrambi.A bitwise combination of AuditFlags values that specify whether to audit successful access, failed access, or both.

Restituisce

Oggetto MutexAuditRule che rappresenta la regola di controllo specificata per l'utente specificato.A MutexAuditRule object representing the specified audit rule for the specified user. Il tipo restituito del metodo è la classe base, AuditRule, ma è possibile effettuare in maniera sicura il cast del valore restituito nella classe derivata.The return type of the method is the base class, AuditRule, but the return value can be cast safely to the derived class.

Eccezioni

accessMask, inheritanceFlags, propagationFlags o flags specifica un valore non valido.accessMask, inheritanceFlags, propagationFlags, or flags specifies an invalid value.

identityReference è null.identityReference is null.

-oppure--or- accessMask è zero.accessMask is zero.

identityReference non è di tipo SecurityIdentifier né di un tipo quale NTAccount convertibile nel tipo SecurityIdentifier.identityReference is neither of type SecurityIdentifier, nor of a type such as NTAccount that can be converted to type SecurityIdentifier.

Commenti

Il metodo consigliato per creare regole di controllo consiste nell'usare i costruttori della classe MutexAuditRule.The recommended way to create audit rules is to use the constructors of the MutexAuditRule class.

Nota

Sebbene i flag di ereditarietà e propagazione non siano significativi per i mutex denominati, è comunque possibile specificarli.Although inheritance and propagation flags are meaningless for named mutexes, it is still possible to specify them. Questa operazione non è consigliata perché complica inutilmente la manutenzione delle regole, ad esempio interferisce con la combinazione di regole che altrimenti sarebbero compatibili.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.

Si applica a