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

Статья
08/25/2023

Функция PeerGraphConnect пытается установить соединение с указанным узлом в одноранговом графе. Эта функция запускает асинхронную операцию. Вызывающее приложение должно ожидать события PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION , чтобы определить, успешно ли выполнена попытка подключения.

Синтаксис

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

Параметры

[in] hGraph

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

[in] pwzPeerId

Уникальный идентификатор однорангового узла для подключения в pAddress. Укажите ЗНАЧЕНИЕ NULL для подключения к любому одноранговому элементу, прослушивателю по указанному адресу в том же одноранговом графе.

[in] pAddress

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

[out] pullConnectionId

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

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_ALREADY_EXISTS	Соседнее подключение к указанному узлу уже существует.
PEER_E_INVALID_GRAPH	Дескриптор однорангового графа недопустим.
PEER_E_NOT_INITIALIZED	Граф необходимо инициализировать с помощью вызова PeerGraphStartup перед использованием этой функции.

Требования


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

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

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData

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