RegistrySecurity.AccessRuleFactory Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Security.AccessControl

Zestaw:: Microsoft.Win32.Registry.dll

Zestaw:: Microsoft.Win32.Registry.AccessControl.dll

Zestaw:: mscorlib.dll

Źródło:: RegistrySecurity.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nową regułę kontroli dostępu dla określonego użytkownika z określonymi prawami dostępu, kontrolą dostępu i flagami.

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

Parametry

identityReference: IdentityReference

Element IdentityReference identyfikujący użytkownika lub grupę, do którego ma zastosowanie reguła.

accessMask: Int32

Bitowa kombinacja wartości określających RegistryRights prawa dostępu do zezwolenia lub odmowy rzutowania na liczbę całkowitą.

isInherited: Boolean

Wartość logiczna określająca, czy reguła jest dziedziczona.

inheritanceFlags: InheritanceFlags

Bitowa kombinacja wartości określających InheritanceFlags , w jaki sposób reguła jest dziedziczona przez podklucze.

propagationFlags: PropagationFlags

Bitowa kombinacja PropagationFlags wartości, które modyfikują sposób dziedziczenia reguły przez podklucze. Bez znaczenia, jeśli wartość to inheritanceFlagsNone.

type: AccessControlType

Jedna z wartości określających AccessControlType , czy prawa są dozwolone, czy niedozwolone.

Zwraca

AccessRule

RegistryAccessRule Obiekt reprezentujący określone prawa określonego użytkownika.

Wyjątki

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlagslub type określa nieprawidłową wartość.

ArgumentNullException

identityReference to null.

-lub-

accessMask jest zero.

ArgumentException

identityReference nie ma typu SecurityIdentifier, ani typu, takiego jak NTAccount typ , który można przekonwertować na typ SecurityIdentifier.

Uwagi

Zalecanym sposobem tworzenia reguł kontroli dostępu jest użycie konstruktorów RegistryAccessRule klasy.

Uwaga

Chociaż można określić flagę InheritanceFlags.ObjectInherit , nie ma sensu tego robić. Na potrzeby kontroli dostępu pary nazw/wartości w podkluczu nie są oddzielnymi obiektami. Prawa dostępu do par name/value są kontrolowane przez prawa podklucza. Ponadto, ponieważ wszystkie podklucze są kontenerami (czyli mogą zawierać inne podklucze), nie mają one wpływu na flagę ObjectInherit . Na koniec określenie flagi ObjectInherit niepotrzebnie komplikuje konserwację reguł, ponieważ zakłóca normalne połączenie reguł zgodnych.

Dotyczy