NamedPipeServerStreamAcl.Create Metoda

Definicja

Przestrzeń nazw:

System.IO.Pipes

Zestaw:

System.IO.Pipes.AccessControl.dll

Tworzy nowe wystąpienie NamedPipeServerStream klasy z określoną nazwą potoku, kierunkiem potoku, maksymalną liczbą wystąpień serwera, trybem transmisji, opcjami potoku, zalecanymi rozmiarami buforów, zabezpieczeniami potoku, trybem dziedziczenia i prawami dostępu potoku.

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

Nazwa potoku.

direction

PipeDirection

Jedna z wartości wyliczenia, która określa kierunek potoku.

maxNumberOfServerInstances

Int32

Maksymalna liczba wystąpień serwera, które mają taką samą nazwę. Tę wartość można przekazać MaxAllowedServerInstances .

transmissionMode

PipeTransmissionMode

Jedna z wartości wyliczenia, która określa tryb transmisji potoku.

options

PipeOptions

Jedna z wartości wyliczenia, która określa sposób otwierania lub tworzenia potoku.

inBufferSize

Int32

Rozmiar buforu wejściowego.

outBufferSize

Int32

Rozmiar buforu wyjściowego.

pipeSecurity

PipeSecurity

Obiekt, który określa zabezpieczenia kontroli dostępu i inspekcji potoku.

inheritability

HandleInheritability

Jedna z wartości wyliczenia, która określa, czy bazowy uchwyt może być dziedziczony przez procesy podrzędne.

additionalAccessRights

PipeAccessRights

Jedna z wartości wyliczenia, która określa prawa dostępu potoku.

Zwraca

NamedPipeServerStream

Nowe nazwane wystąpienie strumienia serwera potoku.

Wyjątki

ArgumentNullException

pipeName to null.

ArgumentException

pipeName jest pusta.

IOException

options to None.

ArgumentOutOfRangeException

options zawiera nieprawidłową flagę.

-lub-

inBufferSize wartość lub outBufferSize jest mniejsza niż zero.

-lub-

maxNumberOfServerInstances nie jest prawidłową liczbą: powinna być większa lub równa 1 i mniejsza niż lub równa 254 lub powinna być ustawiona na wartość MaxAllowedServerInstances.

-lub-

inheritability zawiera nieprawidłową wartość wyliczenia.

-lub-

pipeName jest "anonimowy", który jest zarezerwowany.

Uwagi

Jeśli options element zawiera CurrentUserOnlyelement , przekazany jest ignorowany pipeSecurity , a zwrócony NamedPipeServerStream obiekt jest tworzony przy użyciu wystąpienia niestandardowego PipeSecurity przypisanego do bieżącego użytkownika systemu Windows jako jedynego właściciela z pełną kontrolą potoku.