Compartilhar via

Função GetNamedPipeClientComputerNameA (winbase.h)

  • Artigo

Recupera o nome do computador cliente para o pipe nomeado especificado.

Sintaxe

BOOL GetNamedPipeClientComputerNameA(
  [in]  HANDLE Pipe,
  [out] LPSTR  ClientComputerName,
  [in]  ULONG  ClientComputerNameLength
);

Parâmetros

[in] Pipe

Um identificador para uma instância de um pipe nomeado. Esse identificador deve ser criado pela função CreateNamedPipe .

[out] ClientComputerName

O nome do computador.

[in] ClientComputerNameLength

O tamanho do buffer ClientComputerName , em bytes.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

Windows 10, versão 1709: os pipes só têm suporte em um contêiner de aplicativo; ou seja, de um processo UWP para outro processo UWP que faz parte do mesmo aplicativo. Além disso, os pipes nomeados devem usar a sintaxe \\.\pipe\LOCAL\ para o nome do pipe.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CreateNamedPipe

Funções de pipe

Visão geral de pipes