RegistrySecurity.AccessRuleFactory Metoda

Definicja

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 RegistryRights wartości określających prawa dostępu do zezwalania lub odmowy rzutowania na liczbę całkowitą.

isInherited
Boolean

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

inheritanceFlags
InheritanceFlags

Bitowa kombinacja InheritanceFlags wartości określających sposób dziedziczenia reguły przez podklucze.

propagationFlags
PropagationFlags

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

type
AccessControlType

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

Zwraca

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

Wyjątki

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

identityReference to null.

-lub-

accessMask jest zero.

identityReference nie jest typem ani typem SecurityIdentifier, ani typem, takim jak NTAccount , 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 nazwa/wartość w podkluczu nie są oddzielnymi obiektami. Prawa dostępu do par nazwa/wartość 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 normalną kombinację zgodnych reguł.

Dotyczy