EventWaitHandleSecurity.AuditRuleFactory Methode

Definition

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

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

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

identityReference ist null.

- oder -

accessMask ist 0 (null).

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.

Gilt für: