MutexSecurity.AuditRuleFactory Método

Definição

Namespace:

System.Security.AccessControl

Assembly:

System.Threading.AccessControl.dll

Cria uma nova regra de auditoria, especificando o usuário ao qual a regra se aplica, os direitos de acesso para auditoria e o resultado que dispara a regra de auditoria.

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

Parâmetros

identityReference

IdentityReference

Um IdentityReference que identifica o usuário ou o grupo ao qual a regra se aplica.

accessMask

Int32

Uma combinação bit a bit de valores MutexRights que especifica os direitos de acesso a serem auditados e convertidos em um inteiro.

isInherited

Boolean

Sem utilidade para identificadores de espera nomeados, porque eles não têm nenhuma hierarquia.

inheritanceFlags

InheritanceFlags

Sem utilidade para identificadores de espera nomeados, porque eles não têm nenhuma hierarquia.

propagationFlags

PropagationFlags

Sem utilidade para identificadores de espera nomeados, porque eles não têm nenhuma hierarquia.

flags

AuditFlags

Uma combinação bit a bit de valores AuditFlags que especificam se deve-se auditar acesso com êxito, acesso com falha ou ambos.

Retornos

AuditRule

Um objeto MutexAuditRule que representa a regra de auditoria para o usuário especificado. O tipo de retorno do método é a classe base, AuditRule, mas o valor retornado pode ser convertido com segurança para a classe derivada.

Exceções

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlags ou flags especifica um valor inválido.

ArgumentNullException

identityReference é null.

- ou -

accessMask é zero.

ArgumentException

identityReference não e do tipo SecurityIdentifier nem de um tipo como NTAccount que pode ser convertido para o tipo SecurityIdentifier.

Comentários

A maneira recomendada de criar regras de auditoria é usar os construtores da MutexAuditRule classe .

Observação

Embora os sinalizadores de herança e propagação não tenham sentido para mutexes nomeados, ainda é possível especificá-los. Isso não é recomendado, pois complica desnecessariamente a manutenção de regras, por exemplo, interferindo na combinação de regras que, de outra forma, seriam compatíveis.