EventWaitHandleSecurity.AuditRuleFactory Método

Definição

Namespace:

System.Security.AccessControl

Assembly:

System.Threading.AccessControl.dll

Pacote:

System.Threading.AccessControl v9.0.0-preview.3.24172.9

Origem:

EventWaitHandleSecurity.cs

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 EventWaitHandleRights 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 especifica se a auditoria deve ser realizada em caso de acesso com êxito, com falha ou ambos.

Retornos

AuditRule

Um objeto EventWaitHandleAuditRule que representa a regra de auditoria especificada para o usuário indicado. 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 EventWaitHandleAuditRule classe .

Observação

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