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

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

  • Статья

Функция PeerGraphOpenDirectConnection позволяет приложению установить прямое соединение с узлом в одноранговом графе. Подключение может быть установлено только в том случае, если узел, к которому подключается приложение, подписался на событие PEER_GRAPH_EVENT_DIRECT_CONNECTION . Затем приложение может отправлять данные непосредственно на другой узел. Вызов этой функции является асинхронным.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpenDirectConnection(
  [in]  HGRAPH        hGraph,
  [in]  PCWSTR        pwzPeerId,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Параметры

[in] hGraph

Дескриптор однорангового графа.

[in] pwzPeerId

Указатель на уникальный идентификатор пользователя или узла для подключения. Этот параметр используется для идентификации конкретного пользователя, так как к указанному адресу можно присоединить несколько удостоверений.

[in] pAddress

Указатель на структуру PEER_ADDRESS , содержащую адрес узла для подключения.

[out] pullConnectionId

Получает идентификатор соединения для запрошенного подключения.

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

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

Код возврата Описание
PEER_E_INVALID_GRAPH
 Недопустимый дескриптор графа.
PEER_E_NOT_INITIALIZED
 Перед использованием этой функции граф необходимо инициализировать с помощью вызова PeerGraphStartup.

Комментарии

Вызов PeerGraphOpenDirectConnection является асинхронным. Событие PEER_GRAPH_EVENT_DIRECT_CONNECTION активируется для информирования приложения об успешном или неудачном выполнении прямого подключения. Фактическое состояние успешного или неудачного выполнения функции задается в структуре PEER_GRAPH_EVENT_DATA .

Требования

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

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

PEER_ADDRESS

PeerGraphCloseDirectConnection

PeerGraphEnumConnections