SemaphoreSecurity.AuditRuleFactory Méthode

Définition

Espace de noms:

System.Security.AccessControl

Assembly:

System.Threading.AccessControl.dll

Paquet:

System.Threading.AccessControl v8.0.0

Source:

SemaphoreSecurity.cs

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.

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

isInherited

Boolean

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.

inheritanceFlags

InheritanceFlags

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.

propagationFlags

PropagationFlags

Sans utilité pour les handles d'attente nommés, car ils n'ont pas de hiérarchie.

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.

Retours

AuditRule

Objet SemaphoreAuditRule représentant la règle d'audit spécifiée pour l'utilisateur spécifié. 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 SemaphoreAuditRule classe .

Notes

Bien que les indicateurs d’héritage et de propagation n’aient aucun sens pour les sémaphores nommés, il est toujours possible de les spécifier. Cela n’est pas recommandé, car cela complique inutilement la maintenance des règles, par exemple en interférant avec la combinaison de règles qui seraient autrement compatibles.