NamedPipeServerStreamAcl.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.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 NamedPipeServerStreamParamè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
Nouvelle instance de flux du serveur de canal nommé.
Exceptions
pipeName a la valeur null.
pipeName est vide.
options a la valeur None.
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.
