NamedPipeServerStreamAcl.Create 方法

定义

命名空间:

System.IO.Pipes

程序集:

System.IO.Pipes.AccessControl.dll

使用指定的管道名称、管道方向、最大数量的服务器实例、传输模式、管道选项、建议的输入输出缓冲区大小、管道安全性、继承模式和管道访问权限创建 NamedPipeServerStream 类的新实例。

public static System.IO.Pipes.NamedPipeServerStream Create (string pipeName, System.IO.Pipes.PipeDirection direction, int maxNumberOfServerInstances, System.IO.Pipes.PipeTransmissionMode transmissionMode, System.IO.Pipes.PipeOptions options, int inBufferSize, int outBufferSize, System.IO.Pipes.PipeSecurity? pipeSecurity, System.IO.HandleInheritability inheritability = System.IO.HandleInheritability.None, System.IO.Pipes.PipeAccessRights additionalAccessRights = (System.IO.Pipes.PipeAccessRights) 0);

static member Create : string * System.IO.Pipes.PipeDirection * int * System.IO.Pipes.PipeTransmissionMode * System.IO.Pipes.PipeOptions * int * int * System.IO.Pipes.PipeSecurity * System.IO.HandleInheritability * System.IO.Pipes.PipeAccessRights -> System.IO.Pipes.NamedPipeServerStream

Public Shared Function Create (pipeName As String, direction As PipeDirection, maxNumberOfServerInstances As Integer, transmissionMode As PipeTransmissionMode, options As PipeOptions, inBufferSize As Integer, outBufferSize As Integer, pipeSecurity As PipeSecurity, Optional inheritability As HandleInheritability = System.IO.HandleInheritability.None, Optional additionalAccessRights As PipeAccessRights = (System.IO.Pipes.PipeAccessRights) 0) As NamedPipeServerStream

参数

pipeName

String

管道的名称。

direction

PipeDirection

确定管道方向的枚举值之一。

maxNumberOfServerInstances

Int32

共享同一名称的服务器实例的最大数量。 可以为此值传递 MaxAllowedServerInstances。

transmissionMode

PipeTransmissionMode

确定管道传输模式的枚举值之一。

options

PipeOptions

确定如何打开或创建管道的枚举值之一。

inBufferSize

Int32

输入缓冲区大小。

outBufferSize

Int32

输出缓冲区大小。

pipeSecurity

PipeSecurity

一个对象，确定管道的访问控制和审核安全性。

inheritability

HandleInheritability

确定基础句柄能否由子进程继承的枚举值之一。

additionalAccessRights

PipeAccessRights

枚举值之一，指定管道的访问权限。

返回

NamedPipeServerStream

新的命名管道服务器流实例。

例外

ArgumentNullException

pipeName 为 null。

ArgumentException

pipeName 为空。

IOException

options 为 None。

ArgumentOutOfRangeException

options 包含无效标志。

或

inBufferSize 或 outBufferSize 小于零。

或

maxNumberOfServerInstances 不是有效数字：应大于或等于 1 且小于或等于 254，否则应设置为 MaxAllowedServerInstances 的值。

或

inheritability 包含无效的枚举值。

或

pipeName 是保留的“匿名”。

注解

如果 options 包含 CurrentUserOnly，则忽略传递 pipeSecurity 的 ，并使用 NamedPipeServerStream 分配给当前 Windows 用户的自定义 PipeSecurity 实例创建返回的对象，作为其唯一所有者，且完全控制管道。