Sdílet prostřednictvím

NamedPipeServerStreamAcl.Create Metoda

  • Reference

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.

Platí pro