NamedPipeServerStreamAcl.Create Método

Definición

Espacio de nombres:

System.IO.Pipes

Ensamblado:

System.IO.Pipes.AccessControl.dll

Crea una nueva instancia de la clase NamedPipeServerStream con las características de nombre de la canalización, dirección de la canalización, número máximo de instancias de servidor, modo de transmisión y opciones de canalización especificadas, tamaños de búfer de entrada y salida recomendados, seguridad de la canalización, modo de herencia y derechos de acceso de la canalización.

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

Parámetros

pipeName

String

Nombre de la canalización.

direction

PipeDirection

Uno de los valores de enumeración que determina la dirección de la canalización.

maxNumberOfServerInstances

Int32

Número máximo de instancias de servidor que comparten el mismo nombre. De manera opcional, se puede pasar MaxAllowedServerInstances para este valor.

transmissionMode

PipeTransmissionMode

Uno de los valores de enumeración que determina el modo de transmisión de la canalización.

options

PipeOptions

Uno de los valores de enumeración que determina cómo abrir o crear la canalización.

inBufferSize

Int32

El tamaño del búfer de entrada.

outBufferSize

Int32

El tamaño del búfer de salida.

pipeSecurity

PipeSecurity

Objeto que determina el control de acceso y la seguridad de auditoría de la canalización.

inheritability

HandleInheritability

Uno de los valores de enumeración que determina si los procesos secundarios pueden heredar el identificador subyacente.

additionalAccessRights

PipeAccessRights

Uno de los valores de enumeración que especifica los derechos de acceso de la canalización.

Devoluciones

NamedPipeServerStream

Una nueva instancia de la secuencia del servidor de canalizaciones con nombre.

Excepciones

ArgumentNullException

pipeName es null.

ArgumentException

pipeName está vacía.

IOException

options es None.

ArgumentOutOfRangeException

options contiene una marca no válida.

O bien

inBufferSize o outBufferSize es menor que cero.

O bien

maxNumberOfServerInstances no es un número válido: debe ser mayor o igual que 1 y menor o igual que 254, o bien debe establecerse en el valor de MaxAllowedServerInstances.

O bien

inheritability contiene un valor de enumeración no válido.

O bien

pipeName es "Anonymous", que está reservado.

Comentarios

Si options contiene CurrentUserOnly, se omite el pasado pipeSecurity y el objeto devuelto NamedPipeServerStream se crea mediante una instancia personalizada PipeSecurity asignada al usuario actual de Windows como único propietario con control total de la canalización.