NamedPipeServerStreamAcl.Create Methode

Definition

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.AccessControl.dll

Erstellt eine neue Instanz der NamedPipeServerStream-Klasse mit dem angegebenen Pipenamen, der angegebenen Piperichtung, der angegebenen maximalen Anzahl von Serverinstanzen, dem angegebenen Übertragungsmodus, den angegebenen Pipeoptionen, der empfohlenen Größe für Eingabe- und Ausgabepuffer, der empfohlenen Pipesicherheit, dem angegebenen Vererbbarkeitsmodus und den angegebenen Pipezugriffsrechten.

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

Parameter

pipeName

String

Der Name der Pipe.

direction

PipeDirection

Einer der Enumerationswerte, der die Richtung der Pipe bestimmt.

maxNumberOfServerInstances

Int32

Die maximale Anzahl von Serverinstanzen mit dem gleichen Namen. Für diesen Wert kann MaxAllowedServerInstances übergeben werden.

transmissionMode

PipeTransmissionMode

Einer der Enumerationswerte, der den Übertragungsmodus der Pipe bestimmt.

options

PipeOptions

Einer der Enumerationswerte, der bestimmt, wie die Pipe geöffnet oder erstellt wird.

inBufferSize

Int32

Die Eingabepuffergröße.

outBufferSize

Int32

Die Ausgabepuffergröße.

pipeSecurity

PipeSecurity

Ein Objekt, das die Zugriffssteuerung und die Überwachungssicherheit für die Pipe bestimmt.

inheritability

HandleInheritability

Einer der Enumerationswerte, der bestimmt, ob das zugrunde liegende Handle von untergeordneten Prozessen geerbt werden kann.

additionalAccessRights

PipeAccessRights

Einer der Enumerationswerte, der die Zugriffsrechte der Pipe angibt.

Gibt zurück

NamedPipeServerStream

Eine neue Named Pipe-Serverstreaminstanz.

Ausnahmen

ArgumentNullException

pipeName ist null.

ArgumentException

pipeName ist leer.

IOException

options ist None.

ArgumentOutOfRangeException

options enthält ein ungültiges Flag.

- oder -

inBufferSize oder outBufferSize ist kleiner als 0.

- oder -

maxNumberOfServerInstances ist keine gültige Zahl: Sie sollte größer oder gleich 1 und kleiner oder gleich 254 sein oder auf den Wert MaxAllowedServerInstances festgelegt werden.

- oder -

inheritability enthält einen ungültigen Enumerationswert.

- oder -

pipeName ist „anonymous“, ein reserviertes Wort.

Hinweise

Wenn options enthältCurrentUserOnly, wird das übergebene pipeSecurity ignoriert, und das zurückgegebene NamedPipeServerStream Objekt wird mithilfe einer benutzerdefinierten PipeSecurity instance erstellt, die dem aktuellen Windows-Benutzer als einzigem Besitzer mit voller Kontrolle über die Pipe zugewiesen ist.