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

Функция PeerPnrpGetEndpoint извлекает адрес конечной точки однорангового узла, разрешенный во время асинхронной операции разрешения имен одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpGetEndpoint(
  [in]  HRESOLUTION              hResolve,
  [out] PPEER_PNRP_ENDPOINT_INFO *ppEndpoint
);

Параметры

[in] hResolve

Дескриптор асинхронной операции разрешения имен одноранговых узлов, возвращенный предыдущим вызовом PeerPnrpStartResolve.

[out] ppEndpoint

Указатель на адрес структуры PEER_PNRP_ENDPOINT_INFO , содержащей адрес конечной точки для имени однорангового узла, указанного в предыдущем вызове PeerPnrpStartResolve.

Эти данные, возвращаемые этим параметром, должны быть освобождены путем вызова PeerFreeData.

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

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

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

Комментарии

PeerPnrpStartResolve создает дескриптор для асинхронной операции разрешения имен одноранговых узлов.

Всякий раз, когда конечная точка найдена, сигнализируется дескриптор события, предоставленный в hEvent , и Приложение должно вызывать PeerPnrpGetEndpoint с дескриптором phResolve для получения этой конечной точки.

Последнее событие указывает код ошибки PEER_E_NO_MORE, указывающий, что найдены все конечные точки, соответствующие имени однорангового узла, предоставленному PeerPnrpStartResolve . В настоящее время приложение должно закрыть дескриптор с помощью вызова PeerPnrpEndResolve.

Требования

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

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

PeerPnrpEndResolve

PeerPnrpStartResolve