RegistrySecurity.AccessRuleFactory Metoda
Definicja
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 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
, , inheritanceFlags
propagationFlags
lub type
określa nieprawidłową wartość.
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ł.