Поделиться через


Функция GetNamedPipeClientComputerNameA (winbase.h)

Извлекает имя клиентского компьютера для указанного именованного канала.

Синтаксис

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

Параметры

[in] Pipe

Дескриптор экземпляра именованного канала. Этот дескриптор должен быть создан функцией CreateNamedPipe .

[out] ClientComputerName

имя компьютера.

[in] ClientComputerNameLength

Размер буфера ClientComputerName в байтах.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Комментарии

Windows 10 версии 1709: каналы поддерживаются только в контейнере приложений, т. е. от одного процесса UWP к другому процессу UWP, который является частью того же приложения. Кроме того, именованные каналы должны использовать синтаксис \\.\pipe\LOCAL\ для имени канала.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CreateNamedPipe

Функции канала

Обзор каналов