RegistrySecurity.AuditRuleFactory Methode

Referenz

Definition

Namespace:: System.Security.AccessControl

Assembly:: Microsoft.Win32.Registry.dll

Assembly:: Microsoft.Win32.Registry.AccessControl.dll

Assembly:: mscorlib.dll

Quelle:: RegistrySecurity.cs

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.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

AuditRule

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

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 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: