NamedPipeServerStreamAcl.Create Metodo

Definizione

Spazio dei nomi:

System.IO.Pipes

Assembly:

System.IO.Pipes.AccessControl.dll

Crea una nuova istanza della classe NamedPipeServerStream con il nome e la direzione della pipe, il numero massimo di istanze del server, la modalità di trasmissione, le opzioni di pipe, le dimensioni consigliate del buffer di input e di output, la sicurezza di pipe, la modalità di ereditarietà e le autorizzazioni di accesso della pipe specificati.

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

Parametri

pipeName

String

Nome della pipe.

direction

PipeDirection

Uno dei valori di enumerazione che determina la direzione della pipe.

maxNumberOfServerInstances

Int32

Numero massimo di istanze del server che condividono lo stesso nome. Per questo valore è possibile passare MaxAllowedServerInstances.

transmissionMode

PipeTransmissionMode

Uno dei valori di enumerazione che determina la modalità di trasmissione della pipe.

options

PipeOptions

Uno dei valori di enumerazione che determina come aprire o creare la pipe.

inBufferSize

Int32

Dimensione del buffer di input.

outBufferSize

Int32

Dimensione del buffer di output.

pipeSecurity

PipeSecurity

Oggetto che determina il controllo di accesso e la sicurezza di controllo per la pipe.

inheritability

HandleInheritability

Uno dei valori di enumerazione che determina se l'handle sottostante può essere ereditato dai processi figlio.

additionalAccessRights

PipeAccessRights

Uno dei valori di enumerazione che specifica i diritti di accesso della pipe.

Restituisce

NamedPipeServerStream

Nuova istanza del flusso del server della named pipe.

Eccezioni

ArgumentNullException

pipeName è null.

ArgumentException

pipeName è vuoto.

IOException

options è None.

ArgumentOutOfRangeException

Il parametro options contiene un flag non valido.

-oppure-

inBufferSize o outBufferSize è minore di zero.

-oppure-

maxNumberOfServerInstances non è un numero valido: deve essere maggiore o uguale a 1 e minore o uguale a 254 oppure deve essere impostato sul valore di MaxAllowedServerInstances.

-oppure-

inheritability contiene un valore di enumerazione non valido.

-oppure-

pipeName è "anonimo", ovvero riservato.

Commenti

Se options contiene CurrentUserOnly, l'oggetto passato pipeSecurity viene ignorato e l'oggetto restituito NamedPipeServerStream viene creato utilizzando un'istanza personalizzata PipeSecurity assegnata all'utente di Windows corrente come unico proprietario con controllo completo della pipe.