RegistrySecurity.AuditRuleFactory Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.AuditRulePublic Overrides Function AuditRuleFactory (identityReference As IdentityReference, accessMask As Integer, isInherited As Boolean, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags) As AuditRuleParameter
- 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 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.
