Функция PeerNameToPeerHostName (p2p.h)

Статья
08/25/2023

Функция PeerNameToPeerHostName кодирует указанное имя однорангового узла в формате, который можно использовать при последующем вызове функции getaddrinfo Windows Sockets.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerNameToPeerHostName(
  [in]  PCWSTR pwzPeerName,
  [out] PWSTR  *ppwzHostName
);

Параметры

[in] pwzPeerName

Указатель на строку Юникода с нулем, которая содержит имя однорангового узла для кодирования в качестве имени узла.

[out] ppwzHostName

Указатель на адрес строки Юникода, завершаемой с нуля, которая содержит закодированное имя узла. Эту строку можно передать getaddrinfo_v2 для получения сведений о сети однорангового узла.

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

Если вызов функции завершается успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2P.lib
DLL	P2P.dll

См. также раздел

PeerHostNameToPeerName

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