Noms de canal

Chaque canal nommé a un nom unique qui le distingue des autres canaux nommés dans la liste d’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 à un instance du canal nommé.

Utilisez le formulaire suivant lorsque vous spécifiez le nom d’un canal dans la fonction CreateFile, WaitNamedPipe ou CallNamedPipe :

\\ ServerName\pipe\PipeName

où ServerName est le nom d’un ordinateur distant ou 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 des nombres et des caractères spéciaux. La chaîne de nom de canal entière peut avoir jusqu’à 256 caractères. Les noms de canal ne respectent pas la casse.

Comme le serveur de canal ne peut pas créer de canal sur un autre ordinateur, 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.