RegistrySecurity.AuditRuleFactory Methode

Definition

Erstellt eine neue Überwachungsregel, die den Benutzer angibt, für den die Regel gilt, die Zugriffsrechte für die Überwachung, die Vererbung und Verteilung der Regel sowie das Ergebnis, das die Regel 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

Ein IdentityReference Objekt, das den Benutzer oder die Gruppe identifiziert, für den die Regel gilt.

accessMask
Int32

Eine bitweise Kombination von RegistryRights Werten, die die Zugriffsrechte für die Überwachung angeben, in eine ganze Zahl umgewandelt.

isInherited
Boolean

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

inheritanceFlags
InheritanceFlags

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

propagationFlags
PropagationFlags

Eine bitweise Kombination von PropagationFlags Werten, die die Art und Weise ändern, in der die Regel von Unterschlüsseln geerbt wird. Bedeutungslos, wenn der Wert von inheritanceFlags ist None.

flags
AuditFlags

Eine bitweise Kombination von Werten, die AuditFlags angeben, ob der erfolgreiche Zugriff überwacht, fehlgeschlagener Zugriff oder beides überwacht werden soll.

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 ist die Basisklasse, AuditRuleder Rückgabewert kann jedoch sicher in die abgeleitete Klasse umgeleitet werden.

Ausnahmen

accessMask, inheritanceFlags, propagationFlagsoder flags gibt einen ungültigen Wert an.

identityReference ist null.

-oder-

accessMask ist 0.

identityReference ist weder vom Typ SecurityIdentifiernoch von einem Typ, z NTAccount . B. der in typ SecurityIdentifierkonvertiert werden kann.

Hinweise

Die empfohlene Methode zum Erstellen von Überwachungsregeln besteht darin, die Konstruktoren der RegistryAuditRule Klasse zu verwenden.

Note

Obwohl Sie die InheritanceFlags.ObjectInherit Kennzeichnung angeben können, gibt es keinen Punkt. Für die Zwecke des Überwachungssteuerelements sind die Namen/Wert-Paare in einem Unterschlüssel keine separaten Objekte. Die Überwachungsrechte für Namen-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 von der ObjectInherit Kennzeichnung nicht betroffen. Schließlich erschwert die Angabe der ObjectInherit Kennzeichnung die Wartung von Regeln unnötig, da sie die normale Kombination kompatibler Regeln beeinträchtigt.

Gilt für: