Export (0) Print
Expand All

PipeSecurity.AccessRuleFactory Method

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

Namespace:  System.IO.Pipes
Assembly:  System.Core (in System.Core.dll)

public override AccessRule AccessRuleFactory(
	IdentityReference identityReference,
	int accessMask,
	bool isInherited,
	InheritanceFlags inheritanceFlags,
	PropagationFlags propagationFlags,
	AccessControlType type
)

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.

ExceptionCondition
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.

.NET Framework

Supported in: 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft