PipeSecurity.AccessRuleFactory Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 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.