NamedPipeServerStreamAcl.Create Méthode

Définition

Espace de noms:

System.IO.Pipes

Assembly:

System.IO.Pipes.AccessControl.dll

Crée une instance de la classe NamedPipeServerStream avec le nom du canal, le sens du canal, le nombre maximal d’instances de serveur, le mode de transmission, les options du canal, la sécurité du canal, le mode d’héritage et les autorisations d’accès du canal spécifiés, ainsi que la taille recommandée de la mémoire tampon d’entrée et de sortie.

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

Paramètres

pipeName

String

Nom du canal.

direction

PipeDirection

L'une des valeurs d'énumération qui détermine le sens du canal.

maxNumberOfServerInstances

Int32

Nombre maximal d'instances de serveur partageant le même nom. Vous pouvez passer MaxAllowedServerInstances pour cette valeur.

transmissionMode

PipeTransmissionMode

L'une des valeurs d'énumération déterminant le mode de transmission du canal.

options

PipeOptions

L'une des valeurs d'énumération déterminant le mode d'ouverture ou de création du canal.

inBufferSize

Int32

Taille de la mémoire tampon d'entrée.

outBufferSize

Int32

Taille de la mémoire tampon de sortie.

pipeSecurity

PipeSecurity

Objet qui détermine la sécurité de contrôle d'accès et d'audit du canal.

inheritability

HandleInheritability

L'une des valeurs d'énumération qui détermine si des processus enfants peuvent hériter du handle sous-jacent.

additionalAccessRights

PipeAccessRights

Une des valeurs d'énumération qui spécifie les autorisations d'accès du canal.

Retours

NamedPipeServerStream

Nouvelle instance de flux du serveur de canal nommé.

Exceptions

ArgumentNullException

pipeName a la valeur null.

ArgumentException

pipeName est vide.

IOException

options a la valeur None.

ArgumentOutOfRangeException

options contient un indicateur non valide.

- ou -

inBufferSize ou outBufferSize est inférieur à zéro.

- ou -

maxNumberOfServerInstances n’est pas un nombre valide : il doit être supérieur ou égal à 1 et inférieur ou égal à 254, ou bien défini sur la valeur de MaxAllowedServerInstances.

- ou -

inheritability contient une valeur enum non valide.

- ou -

pipeName est « anonymous », qui est réservé.

Remarques

Si options contient CurrentUserOnly, le passé pipeSecurity est ignoré et l’objet retourné NamedPipeServerStream est créé à l’aide d’un instance personnalisé PipeSecurity attribué à l’utilisateur Windows actuel comme seul propriétaire disposant d’un contrôle total du canal.