NamedPipeServerStreamAcl.Create Método

Definição

Namespace:

System.IO.Pipes

Assembly:

System.IO.Pipes.AccessControl.dll

Cria uma instância da classe NamedPipeServerStream com o nome e a direção do pipe, o número máximo de instâncias do servidor, o modo de transmissão, as opções de pipe, os tamanhos do buffer de entrada e saída recomendados, a segurança do pipe, o modo de herdabilidade e os direitos de acesso do pipe especificados.

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

O nome do pipe.

direction

PipeDirection

Um dos valores de enumeração que determinam a direção do pipe.

maxNumberOfServerInstances

Int32

O número máximo de instâncias de servidor que compartilham o mesmo nome. Você pode passar MaxAllowedServerInstances para esse valor.

transmissionMode

PipeTransmissionMode

Um dos valores de enumeração que determina o modo de transmissão do pipe.

options

PipeOptions

Um dos valores de enumeração que determina como abrir ou criar o pipe.

inBufferSize

Int32

O tamanho do buffer de entrada.

outBufferSize

Int32

O tamanho do buffer de saída.

pipeSecurity

PipeSecurity

Um objeto que determina o controle de acesso e a segurança de auditoria para o pipe.

inheritability

HandleInheritability

Um dos valores de enumeração que determina se o identificador subjacente pode ser herdado por processos filhos.

additionalAccessRights

PipeAccessRights

Um dos valores de enumeração que especifica os direitos de acesso do pipe.

Retornos

NamedPipeServerStream

Uma nova instância nomeada do fluxo de servidor de pipe.

Exceções

ArgumentNullException

pipeName é null.

ArgumentException

pipeName está vazio.

IOException

options é None.

ArgumentOutOfRangeException

options contém um sinalizador inválido.

- ou -

inBufferSize ou outBufferSize é menor que zero.

- ou -

maxNumberOfServerInstances não é um número válido: deve ser maior ou igual a 1 e menor ou igual a 254 ou deve ser definido como o valor de MaxAllowedServerInstances.

- ou -

inheritability contém um valor de enumeração inválido.

- ou -

pipeName é "anônimo", o que é reservado.

Comentários

Se options contiver CurrentUserOnly, o passado pipeSecurity será ignorado e o objeto retornado NamedPipeServerStream será criado usando uma instância personalizada PipeSecurity atribuída ao usuário atual do Windows como seu único proprietário com controle total do pipe.