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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerPnrpResolve(
  [in]           PCWSTR                   pcwzPeerName,
  [in, optional] PCWSTR                   pcwzCloudName,
  [in, out]      ULONG                    *pcEndpoints,
  [out]          PPEER_PNRP_ENDPOINT_INFO *ppEndpoints
);

Параметры

[in] pcwzPeerName

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

[in, optional] pcwzCloudName

Указатель на строку с нулем, содержащую имя облака PNRP, в котором разрешается имя однорангового узла. Если значение РАВНО NULL, разрешение выполняется во всех облаках. Если PEER_PNRP_ALL_LINK_CLOUDS, разрешение выполняется во всех локальных облаках связи. При GLOBAL_ разрешение будет выполняться только в глобальном облаке.

[in, out] pcEndpoints

Максимальное число возвращаемых конечных точек в ppEndpoints. После возврата этот параметр содержит фактическое количество конечных точек в ppEndpoints.

[out] ppEndpoints

Указатель на список PEER_PNRP_ENDPOINT_INFO структур, содержащих конечные точки, для которых имя однорангового узла успешно разрешено. Каждая конечная точка содержит один или несколько IP-адресов, по которым можно получить доступ к одноранговому узлу.

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

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

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

Комментарии

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

Дескриптор должен быть разрешен в процессе, отдельном от процесса, в который он был зарегистрирован. Если дескриптор зарегистрирован и разрешен в рамках одного процесса, он не будет распознана.

При выполнении разрешения для всех облаков оно выдается в каждое облако одновременно. Метод вернет, как только получит достаточно результатов из любого сочетания облаков.

Время ожидания разрешения по умолчанию, используемое этим методом, составляет 30 секунд. Если требуется определенное время ожидания, следует использовать асинхронную функцию PeerPnrpStartResolve .

Требования

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

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

PeerPnrpStartResolve