NamedPipeServerStream Constructor (String, PipeDirection, Int32)

 

Initializes a new instance of the NamedPipeServerStream class with the specified pipe name, pipe direction, and maximum number of server instances.

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

public NamedPipeServerStream(
	string pipeName,
	PipeDirection direction,
	int maxNumberOfServerInstances
)

Parameters

pipeName
Type: System.String

The name of the pipe.

direction
Type: System.IO.Pipes.PipeDirection

One of the enumeration values that determines the direction of the pipe.

maxNumberOfServerInstances
Type: System.Int32

The maximum number of server instances that share the same name. You can pass MaxAllowedServerInstances for this value.

Exception Condition
ArgumentNullException

pipeName is null.

ArgumentException

pipeName is a zero-length string.

ArgumentOutOfRangeException

pipeName is set to "anonymous".

-or-

direction is not a valid PipeDirection value.

-or-

A non-negative number is required.

-or-

maxNumberofServerInstances is less than -1 or greater than 254 (-1 indicates MaxAllowedServerInstances)

-or-

None or Inheritable is required.

-or-

Access rights is limited to the ChangePermissions , TakeOwnership , and AccessSystemSecurity flags.

NotSupportedException

pipeName contains a colon (":").

PlatformNotSupportedException

The operating system is Windows Millennium Edition, Windows 98, or Windows 95, which are not supported.

IOException

The maximum number of server instances has been exceeded.

This constructor creates a NamedPipeServerStream object that has the following characteristics:

Demand

For full trust for the immediate caller. This member cannot be used by partially trusted code.

.NET Framework
Available since 3.5
Return to top
Show: