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的 ，並使用指派給目前 Windows 使用者之自定義PipeSecurity實例建立傳NamedPipeServerStream回的物件，做為其唯一擁有者，並完全控制管道。