NamedPipeServerStreamAcl.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用指定的管道名称、管道方向、最大数量的服务器实例、传输模式、管道选项、建议的输入输出缓冲区大小、管道安全性、继承模式和管道访问权限创建 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
枚举值之一,指定管道的访问权限。
返回
新的命名管道服务器流实例。
例外
pipeName
为 null
。
pipeName
为空。
options
为 None。
options
包含无效标志。
或
inBufferSize
或 outBufferSize
小于零。
或
maxNumberOfServerInstances
不是有效数字:应大于或等于 1 且小于或等于 254,否则应设置为 MaxAllowedServerInstances 的值。
或
inheritability
包含无效的枚举值。
或
pipeName
是保留的“匿名”。
注解
如果 options
包含 CurrentUserOnly,则忽略传递 pipeSecurity
的 ,并使用 NamedPipeServerStream 分配给当前 Windows 用户的自定义 PipeSecurity 实例创建返回的对象,作为其唯一所有者,且完全控制管道。