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 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.NamedPipeServerStreamPublic 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 NamedPipeServerStreamParameter
- 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
Eine neue Named Pipe-Serverstreaminstanz.
Ausnahmen
pipeName ist null.
pipeName ist leer.
options ist None.
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.
