RegistrySecurity.AccessRuleFactory Metoda

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

Microsoft.Win32.Registry.dll

Vytvoří nové pravidlo řízení přístupu pro zadaného uživatele se zadanými přístupovými právy, řízením přístupu a příznaky.

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

Určuje IdentityReference uživatele nebo skupinu, na které se pravidlo vztahuje.

accessMask

Int32

Bitová RegistryRights kombinace hodnot určujících přístupová práva k povolení nebo zamítnutí přetypování na celé číslo.

isInherited

Boolean

Logická hodnota určující, zda je pravidlo zděděno.

inheritanceFlags

InheritanceFlags

Bitové kombinace hodnot určující, InheritanceFlags jak je pravidlo zděděno podklíči.

propagationFlags

PropagationFlags

Bitové kombinace PropagationFlags hodnot, které upravují způsob, jakým je pravidlo zděděno podklíči. Bez významu, pokud je inheritanceFlagshodnota None .

type

AccessControlType

Jedna z AccessControlType hodnot určujících, zda jsou práva povolena nebo odepřena.

Návraty

AccessRule

Objekt RegistryAccessRule představující zadaná práva pro zadaného uživatele.

Výjimky

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlagsnebo type určuje neplatnou hodnotu.

ArgumentNullException

identityReference je null.

nebo

accessMask je nula.

ArgumentException

identityReference není typu SecurityIdentifier, ani typu, jako NTAccount je například lze převést na typ SecurityIdentifier.

Poznámky

Doporučeným způsobem vytvoření pravidel řízení přístupu je použití konstruktorů RegistryAccessRule třídy.

Note

I když můžete příznak zadat InheritanceFlags.ObjectInherit , není v tom žádný smysl. Pro účely řízení přístupu nejsou dvojice name/value v podklíči samostatné objekty. Přístupová práva k párům název/hodnota jsou řízena právy podklíče. Vzhledem k tomu, že všechny podklíče jsou kontejnery (to znamená, že mohou obsahovat další podklíče), nejsou příznakem ObjectInherit ovlivněny. Nakonec zadání příznaku ObjectInherit zbytečně komplikuje údržbu pravidel, protože koliduje s normální kombinací kompatibilních pravidel.