PipeSecurity::AccessRuleFactory Method (IdentityReference^, Int32, Boolean, InheritanceFlags, PropagationFlags, AccessControlType)
Initializes a new instance of the AccessRule class with the specified values.
Assembly: System.Core (in System.Core.dll)
public: virtual AccessRule^ AccessRuleFactory( IdentityReference^ identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type ) override
Parameters
- identityReference
-
Type:
System.Security.Principal::IdentityReference^
The identity that the access rule applies to. It must be an object that can be cast as a SecurityIdentifier object.
- accessMask
-
Type:
System::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
-
Type:
System::Boolean
true if this rule is inherited from a parent container; otherwise false.
- inheritanceFlags
-
Type:
System.Security.AccessControl::InheritanceFlags
One of the InheritanceFlags values that specifies the inheritance properties of the access rule.
- propagationFlags
-
Type:
System.Security.AccessControl::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
-
Type:
System.Security.AccessControl::AccessControlType
Specifies the valid access control type.
Return Value
Type: System.Security.AccessControl::AccessRule^The AccessRule object that this method creates.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | accessMask, inheritanceFlags, propagationFlags, or type specifies an invalid value. |
| ArgumentNullException | identityReference is null. -or- accessMask is zero. |
| ArgumentException | identityReference is neither of type SecurityIdentifier nor of a type, such as NTAccount, that can be converted to type SecurityIdentifier. |
The recommended way to create access control rules is to use the constructors of the PipeAccessRule class.
Available since 3.5