NamedPipeServerStreamAcl.Create Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.