NamedPipeServerStream Constructor (String^, PipeDirection, Int32, PipeTransmissionMode, PipeOptions, Int32, Int32, PipeSecurity^, HandleInheritability)
Initializes a new instance of the NamedPipeServerStream class with the specified pipe name, pipe direction, maximum number of server instances, transmission mode, pipe options, recommended in and out buffer sizes, pipe security, and inheritability mode.
Assembly: System.Core (in System.Core.dll)
public: NamedPipeServerStream( String^ pipeName, PipeDirection direction, int maxNumberOfServerInstances, PipeTransmissionMode transmissionMode, PipeOptions options, int inBufferSize, int outBufferSize, PipeSecurity^ pipeSecurity, HandleInheritability inheritability )
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.
- transmissionMode
-
Type:
System.IO.Pipes::PipeTransmissionMode
One of the enumeration values that determines the transmission mode of the pipe.
- options
-
Type:
System.IO.Pipes::PipeOptions
One of the enumeration values that determines how to open or create the pipe.
- inBufferSize
-
Type:
System::Int32
A positive value greater than 0 that indicates the input buffer size.
- outBufferSize
-
Type:
System::Int32
A positive value greater than 0 that indicates the output buffer size.
- pipeSecurity
-
Type:
System.IO.Pipes::PipeSecurity^
An object that determines the access control and audit security for the pipe.
- inheritability
-
Type:
System.IO::HandleInheritability
One of the enumeration values that determines whether the underlying handle can be inherited by child processes.
| 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- maxNumberofServerInstances is less than -1 or greater than 254 (-1 indicates MaxAllowedServerInstances) -or- options is not a valid PipeOptions value. -or- inBufferSize is negative. -or- inheritability is not a valid HandleInheritability value. |
| 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 no specified additional PipeAccessRights.
For full trust for the immediate caller. This member cannot be used by partially trusted code.
Available since 3.5