Noms de canal

Chaque canal nommé a un nom unique qui le distingue des autres canaux nommés dans la liste des objets nommés du système. Un serveur de canal spécifie un nom pour le canal lorsqu’il appelle la fonction CreateNamedPipe pour créer une ou plusieurs instances d’un canal nommé. Les clients de canal spécifient le nom du canal lorsqu’ils appellent la fonction CreateFile ou CallNamedPipe pour se connecter à une instance du canal nommé.

Utilisez le formulaire suivant lors de la spécification du nom d’un canal dans l'CreateFile, WaitNamedPipeou fonction CallNamedPipe :

\\ Nom_serveur\pipe\PipeName

où Nom_serveur est le nom d’un ordinateur distant ou d’un point, pour spécifier l’ordinateur local. La chaîne de nom de canal spécifiée par PipeName peut inclure n’importe quel caractère autre qu’une barre oblique inverse, y compris les nombres et les caractères spéciaux. La chaîne de nom de canal entière peut comporter jusqu’à 256 caractères. Les noms de canal ne respectent pas la casse.

Le serveur de canal ne peut pas créer de canal sur un autre ordinateur. Par conséquent, CreateNamedPipe doit utiliser un point pour le nom du serveur, comme illustré dans l’exemple suivant.

\\.\pipe\ PipeName

Un serveur de canal peut fournir le nom du canal à ses clients de canal, afin qu’ils puissent se connecter au canal. Le client de canal découvre le nom du canal à partir d’une source persistante, telle qu’une entrée de Registre, un fichier ou une autre application. Sinon, les clients doivent connaître le nom du canal au moment de la compilation.