RegistrySecurity.AccessRuleFactory Methode

Definition

Erstellt eine neue Zugriffssteuerungsregel für den angegebenen Benutzer mit den angegebenen Zugriffsrechten und Flags sowie der angegebenen Zugriffssteuerung.

public:
 override System::Security::AccessControl::AccessRule ^ AccessRuleFactory(System::Security::Principal::IdentityReference ^ identityReference, int accessMask, bool isInherited, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);
public override System.Security.AccessControl.AccessRule AccessRuleFactory (System.Security.Principal.IdentityReference identityReference, int accessMask, bool isInherited, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);
override this.AccessRuleFactory : System.Security.Principal.IdentityReference * int * bool * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.AccessRule
Public Overrides Function AccessRuleFactory (identityReference As IdentityReference, accessMask As Integer, isInherited As Boolean, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType) As AccessRule

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 verweigernden oder zu gewährenden 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.

type
AccessControlType

Einer der AccessControlType-Werte, mit denen angegeben wird, ob die Rechte gewährt oder verweigert werden.

Gibt zurück

Ein RegistryAccessRule-Objekt, das die angegebenen Rechte für den angegebenen Benutzer darstellt.

Ausnahmen

Für accessMask, inheritanceFlags, propagationFlags oder type 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 Zugriffssteuerungsregeln besteht darin, die Konstruktoren der RegistryAccessRule -Klasse zu verwenden.

Hinweis

Obwohl Sie das InheritanceFlags.ObjectInherit Flag angeben können, hat dies keinen Sinn. Für die Zugriffssteuerung sind die Name-Wert-Paare in einem Unterschlüssel keine separaten Objekte. Die Zugriffsrechte auf 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 es die normale Kombination kompatibler Regeln beeinträchtigt.

Gilt für: