NamedPipeServerStreamAcl.Create Metoda

Definice

Obor názvů:

System.IO.Pipes

Sestavení:

System.IO.Pipes.AccessControl.dll

Vytvoří novou instanci NamedPipeServerStream třídy se zadaným názvem kanálu, směrem kanálu, maximálním počtem instancí serveru, režimem přenosu, možnostmi kanálu, doporučenými velikostmi vyrovnávací paměti, zabezpečením kanálu, režimem dědičnosti a přístupovými právy kanálu.

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

Parametry

pipeName

String

Název kanálu.

direction

PipeDirection

Jedna z hodnot výčtu, která určuje směr potrubí.

maxNumberOfServerInstances

Int32

Maximální počet instancí serveru, které sdílejí stejný název. Tuto hodnotu můžete předat MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z hodnot výčtu, která určuje režim přenosu potrubí.

options

PipeOptions

Jedna z hodnot výčtu, která určuje, jak kanál otevřít nebo vytvořit.

inBufferSize

Int32

Velikost vstupní vyrovnávací paměti.

outBufferSize

Int32

Velikost výstupní vyrovnávací paměti.

pipeSecurity

PipeSecurity

Objekt, který určuje řízení přístupu a zabezpečení auditu kanálu.

inheritability

HandleInheritability

Jedna z hodnot výčtu, která určuje, zda podkladový popisovač může být zděděna podřízenými procesy.

additionalAccessRights

PipeAccessRights

Jedna z hodnot výčtu, která určuje přístupová práva kanálu.

Návraty

NamedPipeServerStream

Nová instance datového proudu serveru pojmenovaného kanálu.

Výjimky

ArgumentNullException

pipeName je null.

ArgumentException

pipeName je prázdný.

IOException

options je None.

ArgumentOutOfRangeException

options obsahuje neplatný příznak.

-nebo-

inBufferSize nebo outBufferSize je menší než nula.

-nebo-

maxNumberOfServerInstances není platné číslo: mělo by být větší nebo rovno 1 a menší nebo rovno 254 nebo by mělo být nastaveno na hodnotu MaxAllowedServerInstances.

-nebo-

inheritability obsahuje neplatnou hodnotu výčtu.

-nebo-

pipeName je anonymní, což je vyhrazeno.

Poznámky

Pokud options obsahuje CurrentUserOnly, předaný pipeSecurity objekt se ignoruje a vrácený NamedPipeServerStream objekt se vytvoří pomocí vlastní PipeSecurity instance přiřazené aktuálnímu uživateli systému Windows jako jediného vlastníka s úplným řízením nad kanálem.