RegistrySecurity.AccessRuleFactory Método

Definição

Namespace:

System.Security.AccessControl

Assembly:

Microsoft.Win32.Registry.dll

Pacote:

Microsoft.Win32.Registry v5.0.0

Cria uma nova regra de controle de acesso para o usuário especificado, com os direitos de acesso, o controle de acesso e os sinalizadores especificados.

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

Parâmetros

identityReference

IdentityReference

Um IdentityReference que identifica o usuário ou o grupo ao qual a regra se aplica.

accessMask

Int32

Uma combinação bit a bit de valores RegistryRights que especificam os direitos de acesso a serem permitidos ou negados, convertidos em um inteiro.

isInherited

Boolean

Um valor booliano que especifica se a regra é herdada.

inheritanceFlags

InheritanceFlags

Uma combinação bit a bit de valores InheritanceFlags que especificam como a regra é herdada por subchaves.

propagationFlags

PropagationFlags

Uma combinação bit a bit de valores PropagationFlags que modificam o modo como a regra é herdada por subchaves. Sem sentido se o valor de inheritanceFlags for None.

type

AccessControlType

Um dos valores AccessControlType que especificam se os direitos são permitidos ou negados.

Retornos

AccessRule

Um objeto RegistryAccessRule que representa os direitos especificados para o usuário especificado.

Exceções

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlags ou type especifica um valor inválido.

ArgumentNullException

identityReference é null.

- ou -

accessMask é zero.

ArgumentException

identityReference não e do tipo SecurityIdentifier nem de um tipo como NTAccount que pode ser convertido para o tipo SecurityIdentifier.

Comentários

A maneira recomendada de criar regras de controle de acesso é usar os construtores da RegistryAccessRule classe .

Observação

Embora você possa especificar o InheritanceFlags.ObjectInherit sinalizador, não há nenhum ponto em fazê-lo. Para fins de controle de acesso, os pares nome/valor em uma subchave não são objetos separados. Os direitos de acesso aos pares nome/valor são controlados pelos direitos da subchave. Além disso, como todas as subchaves são contêineres (ou seja, podem conter outras subchaves), elas não são afetadas pelo ObjectInherit sinalizador. Por fim, especificar o ObjectInherit sinalizador complica desnecessariamente a manutenção das regras, pois ele interfere na combinação normal de regras compatíveis.