RegistrySecurity.AccessRuleFactory Método

Definição

Cria uma nova regra de controle de acesso para o usuário especificado, com os direitos de acesso, controle de acesso e 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 RegistryRights valores que especificam os direitos de acesso para permitir ou negar, convertidos em um inteiro.

isInherited
Boolean

Um valor booliano que especifica se a regra é herdada.

inheritanceFlags
InheritanceFlags

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

propagationFlags
PropagationFlags

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

type
AccessControlType

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

Retornos

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

Exceções

accessMask, inheritanceFlagsou propagationFlagstype especifica um valor inválido.

identityReference é null.

-ou-

accessMask é zero.

identityReference não é do tipo SecurityIdentifier, nem de um tipo como NTAccount esse pode ser convertido em tipo SecurityIdentifier.

Comentários

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

Note

Embora você possa especificar o InheritanceFlags.ObjectInherit sinalizador, não faz sentido fazer isso. Para fins de controle de acesso, os pares nome/valor em uma subchave não são objetos separados. Os direitos de acesso a 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.

Aplica-se a