NamedPipeServerStreamAcl.Create Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Nuova istanza del flusso del server della named pipe.
Eccezioni
pipeName
è null
.
pipeName
è vuoto.
options
è None.
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.