NamedPipeServerStreamAcl.Create Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Nowe nazwane wystąpienie strumienia serwera potoku.
Wyjątki
pipeName
to null
.
pipeName
jest pusta.
options
to None.
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.