Sprache

NamedPipeServerStreamAcl.Create Methode

Definition

Erstellt eine neue Instanz der NamedPipeServerStream Klasse mit dem angegebenen Pipenamen, der Piperichtung, der maximalen Anzahl von Serverinstanzen, übertragungsmodus, Pipeoptionen, empfohlen in und out Puffergrößen, Pipesicherheit, Vererbbarkeitsmodus und Pipezugriffsrechte.

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 Pfeife.

direction
PipeDirection

Einer der Enumerationswerte, die die Richtung der Pipe bestimmt.

maxNumberOfServerInstances
Int32

Die maximale Anzahl von Serverinstanzen, die denselben Namen aufweisen. Sie können diesen Wert übergeben MaxAllowedServerInstances .

transmissionMode
PipeTransmissionMode

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

options
PipeOptions

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

inBufferSize
Int32

Die Größe des Eingabepuffers.

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, die die Zugriffsrechte der Pipe angibt.

Gibt zurück

Eine neue Benannte Pipelineserverstreaminstanz.

Ausnahmen

pipeName ist null.

pipeName ist leer.

options ist None.

options enthält ein ungültiges Kennzeichen.

-oder-

inBufferSize oder outBufferSize ist kleiner als Null.

-oder-

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

-oder-

inheritability enthält einen ungültigen Enumerationswert.

-oder-

pipeName ist "anonym", was reserviert ist.

Hinweise

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

Gilt für: