RegistrySecurity.AccessRuleFactory Método

Definición

Espacio de nombres:

System.Security.AccessControl

Ensamblado:

Microsoft.Win32.Registry.dll

Paquete:

Microsoft.Win32.Registry v5.0.0

Crea una nueva regla de control de acceso para el usuario indicado con los derechos de acceso, el control de acceso y los marcadores 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

Objeto IdentityReference que identifica al usuario o grupo al que se aplica la regla.

accessMask

Int32

Combinación de valores RegistryRights bit a bit que especifica los derechos de acceso que se van a conceder o denegar, convertidos a un entero.

isInherited

Boolean

Un valor booleano que especifica si se hereda la regla.

inheritanceFlags

InheritanceFlags

Una combinación bit a bit de valores InheritanceFlags que especifica cómo las subclaves heredan la regla.

propagationFlags

PropagationFlags

Una combinación bit a bit de valores PropagationFlags que modifican la manera en que las subclaves heredan la regla. No tiene sentido si el valor de inheritanceFlags es None.

type

AccessControlType

Uno de los valores de AccessControlType que especifica si se conceden o deniegan los derechos.

Devoluciones

AccessRule

Objeto RegistryAccessRule que representa los derechos indicados para el usuario especificado.

Excepciones

ArgumentOutOfRangeException

accessMask, inheritanceFlags, propagationFlags o type especifican un valor no válido.

ArgumentNullException

identityReference es null.

o bien

accessMask es cero.

ArgumentException

identityReference no es de tipo SecurityIdentifier, ni de un tipo que, como NTAccount, se pueda convertir al tipo SecurityIdentifier.

Comentarios

La manera recomendada de crear reglas de control de acceso es usar los constructores de la RegistryAccessRule clase .

Nota

Aunque puede especificar la InheritanceFlags.ObjectInherit marca, no hay ningún punto para hacerlo. Para el control de acceso, los pares nombre-valor de una subclave no son objetos independientes. Los derechos de acceso a los pares nombre-valor se controlan mediante los derechos de la subclave. Además, dado que todas las subclaves son contenedores (es decir, pueden contener otras subclaves), no se ven afectadas por la ObjectInherit marca . Por último, especificar la ObjectInherit marca complica innecesariamente el mantenimiento de las reglas, ya que interfiere con la combinación normal de reglas compatibles.