EventWaitHandleSecurity.AuditRuleFactory Methode

Definition

Namespace:

System.Security.AccessControl

Assembly:

System.Threading.AccessControl.dll

Paket:

System.Threading.AccessControl v9.0.0-rc.2.24473.5

Quelle:

EventWaitHandleSecurity.cs

Erstellt eine neue Überwachungsregel, die den Benutzer angibt, auf den diese Regel angewendet wird, sowie die zu überwachenden Zugriffsrechte und das Ergebnis, das die Überwachungsregel auslöst.

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

Parameter

identityReference

IdentityReference

Eine IdentityReference, mit deren Hilfe der Benutzer oder die Gruppe angegeben wird, für den bzw. die die Regel gilt.

accessMask

Int32

Eine bitweise Kombination von EventWaitHandleRights-Werten, die die zu überwachenden Zugriffsrechte angibt (in eine ganze Zahl umgewandelt).

isInherited

Boolean

Besitzt keine Bedeutung für benannte WaitHandles, da diese über keine Hierarchie verfügen.

inheritanceFlags

InheritanceFlags

Besitzt keine Bedeutung für benannte WaitHandles, da diese über keine Hierarchie verfügen.

propagationFlags

PropagationFlags

Besitzt keine Bedeutung für benannte WaitHandles, da diese über keine Hierarchie verfügen.

flags

AuditFlags

Eine bitweise Kombination von AuditFlags-Werten, die angibt, ob erfolgreiche Zugriffsversuche und/oder fehlgeschlagene Zugriffsversuche überwacht werden sollen.

Gibt zurück

AuditRule

Ein EventWaitHandleAuditRule-Objekt, das die angegebene Überwachungsregel für den angegebenen Benutzer darstellt. Der Rückgabetyp der Methode entspricht der Basisklasse AuditRule, er kann jedoch problemlos in die abgeleitete Klasse umgewandelt werden.

Ausnahmen

ArgumentOutOfRangeException

Für accessMask, inheritanceFlags, propagationFlags oder flags ist ein ungültiger Wert angegeben.

ArgumentNullException

identityReference ist null.

- oder -

accessMask ist 0 (null).

ArgumentException

identityReference ist weder vom Typ SecurityIdentifier noch von einem Typ wie etwa NTAccount, der in den SecurityIdentifier-Typ konvertiert werden kann.

Hinweise

Die empfohlene Möglichkeit zum Erstellen von Überwachungsregeln ist die Verwendung der Konstruktoren der EventWaitHandleAuditRule -Klasse.

Hinweis

Obwohl Vererbungs- und Weitergabeflags für benannte Ereignisse bedeutungslos sind, ist es dennoch möglich, sie anzugeben. Dies wird nicht empfohlen, da es die Wartung von Regeln unnötig erschwert, z. B. durch Eingriffe in die Kombination von Regeln, die andernfalls kompatibel wären.