Freigeben über


RegistrySecurity.AuditRuleFactory Methode

Definition

Erstellt eine neue Überwachungsregel, die den Benutzer angibt, auf den diese Regel angewendet wird, sowie die zu überwachenden Zugriffsrechte, die Vererbung und Weitergabe der Regel 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 RegistryRights-Werten, die die zu überwachenden Zugriffsrechte angibt (in eine ganze Zahl umgewandelt).

isInherited
Boolean

Ein boolescher Wert, der angibt, ob die Regel geerbt ist.

inheritanceFlags
InheritanceFlags

Eine bitweise Kombination von InheritanceFlags-Werten, die angibt, wie die Regel von Unterschlüsseln geerbt wird.

propagationFlags
PropagationFlags

Eine bitweise Kombination von PropagationFlags-Werten, die die Art der Vererbung der Regel für die Unterschlüssel ändert. Irrelevant, wenn der Wert von inheritanceFlagsNone ist.

flags
AuditFlags

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

Gibt zurück

Ein RegistryAuditRule-Objekt, das die angegebene Überwachungsregel für den angegebenen Benutzer mit den angegebenen Flags 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 RegistryAuditRule -Klasse.

Hinweis

Obwohl Sie das InheritanceFlags.ObjectInherit Flag angeben können, hat es keinen Sinn, dies zu tun. Für die Überwachungssteuerung sind die Name-Wert-Paare in einem Unterschlüssel keine separaten Objekte. Die Überwachungsrechte für Name/Wert-Paare werden durch die Rechte des Unterschlüssels gesteuert. Da es sich bei allen Unterschlüsseln um Container handelt (d. h. sie können andere Unterschlüssel enthalten), sind sie vom ObjectInherit Flag nicht betroffen. Schließlich erschwert die Angabe des ObjectInherit Flags unnötigerweise die Wartung von Regeln, da sie die normale Kombination kompatibler Regeln beeinträchtigt.

Gilt für: