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


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

Функция PeerGraphSendData отправляет данные на соседний узел или непосредственно подключенный узел.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSendData(
  [in] HGRAPH     hGraph,
  [in] ULONGLONG  ullConnectionId,
  [in] const GUID *pType,
  [in] ULONG      cbData,
  [in] PVOID      pvData
);

Параметры

[in] hGraph

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

[in] ullConnectionId

Указывает уникальный идентификатор подключения для отправки данных.

[in] pType

Указывает определяемый приложением тип данных для отправки. Этот параметр не может иметь значение NULL.

[in] cbData

Указывает количество байтов, на которые указывает pvData.

[in] pvData

Указатель на отправляемые данные.

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

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

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

Комментарии

Функция PeerGraphSendData возвращается сразу после отправки данных на сетевой уровень; Уровень однорангового графирования не ожидает подтверждения с другой стороны подключения.

Примечание Чтобы иметь возможность получать данные с помощью прямого подключения, приложение должно зарегистрировать одноранговое событие типа PEER_GRAPH_EVENT_INCOMING_DATA. См . раздел PeerGraphRegisterEvent.
 

Требования

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

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

PeerGraphEnumConnections

PeerGraphOpenDirectConnection

PeerGraphRegisterEvent