NamedPipeServerStreamAcl.Create Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.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 NamedPipeServerStreamParâ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
Uma nova instância nomeada do fluxo de servidor de pipe.
Exceções
pipeName é null.
pipeName está vazio.
options é None.
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.
