Partager via


GetNamedPipeClientComputerNameW, fonction (namedpipeapi.h)

Récupère le nom de l’ordinateur client pour le canal nommé spécifié.

Syntaxe

BOOL GetNamedPipeClientComputerNameW(
  [in]  HANDLE Pipe,
  [out] LPWSTR ClientComputerName,
  [in]  ULONG  ClientComputerNameLength
);

Paramètres

[in] Pipe

Handle vers un instance d’un canal nommé. Ce handle doit être créé par la fonction CreateNamedPipe .

[out] ClientComputerName

Nom de l'ordinateur.

[in] ClientComputerNameLength

Taille de la mémoire tampon ClientComputerName , en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Remarques

Windows 10, version 1709 : les canaux ne sont pris en charge que dans un conteneur d’application, c’est-à-dire, d’un processus UWP à un autre processus UWP qui fait partie de la même application. En outre, les canaux nommés doivent utiliser la syntaxe \\.\pipe\LOCAL\ du nom du canal.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête namedpipeapi.h
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CreateNamedPipe
Fonctions de canal
Vue d’ensemble des canaux