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.
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:
A default value of 1 for the maximum number of server instances that share the same name.
A default PipeTransmissionMode value of Byte.
A PipeOptions value of None.
Default input and output buffer sizes.
No pipe security.
A HandleInheritability value of None.
No specified additional PipeAccessRights.
For full trust for the immediate caller. This member cannot be used by partially trusted code.
Available since 3.5