PipeSecurity.AccessRuleFactory Method

Definition

Initializes a new instance of the AccessRule class with the specified values.

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

Parameters

identityReference
IdentityReference

The identity that the access rule applies to. It must be an object that can be cast as a SecurityIdentifier object.

accessMask
Int32

The access mask of this rule. The access mask is a 32-bit collection of anonymous bits, the meaning of which is defined by the individual integrators.

isInherited
Boolean

true if this rule is inherited from a parent container; otherwise, false.

inheritanceFlags
InheritanceFlags

One of the InheritanceFlags values that specifies the inheritance properties of the access rule.

propagationFlags
PropagationFlags

One of the PropagationFlags values that specifies whether inherited access rules are automatically propagated. The propagation flags are ignored if inheritanceFlags is set to None.

type
AccessControlType

Specifies the valid access control type.

Returns

The AccessRule object that this method creates.

Exceptions

accessMask, inheritanceFlags, propagationFlags, or type specifies an invalid value.

identityReference is null.

-or-

accessMask is zero.

identityReference is neither of type SecurityIdentifier nor of a type, such as NTAccount, that can be converted to type SecurityIdentifier.

Remarks

The recommended way to create access control rules is to use the constructors of the PipeAccessRule class.

Applies to