RegistrySecurity.AccessRuleFactory Methode

Referenz

Definition

Namespace:: System.Security.AccessControl

Assembly:: Microsoft.Win32.Registry.dll

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

Assembly:: mscorlib.dll

Paket:: Microsoft.Win32.Registry v5.0.0

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

AccessRule

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

Ausnahmen

ArgumentOutOfRangeException

Für accessMask, inheritanceFlags, propagationFlags oder type 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 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:

Freigeben über