Partager via


GetNamedPipeClientComputerNameA, fonction (winbase.h)

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

Syntaxe

BOOL GetNamedPipeClientComputerNameA(
  [in]  HANDLE Pipe,
  [out] LPSTR  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 vers un autre processus UWP faisant 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 winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CreateNamedPipe

Fonctions de canal

Vue d’ensemble des canaux