NamedPipeServerStreamAcl.Create Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Una nueva instancia de la secuencia del servidor de canalizaciones con nombre.
Excepciones
pipeName
es null
.
pipeName
está vacía.
options
es None.
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.