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


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

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSendData(
  [in] HGROUP     hGroup,
  [in] ULONGLONG  ullConnectionId,
  [in] const GUID *pType,
  [in] ULONG      cbData,
  [in] PVOID      pvData
);

Параметры

[in] hGroup

Дескриптор для группы, содержащей оба члена соединения. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] ullConnectionId

64-разрядное целое число без знака, содержащее идентификатор соединения, в котором размещается передача данных. Идентификатор подключения получается путем вызова PeerGroupOpenDirectConnection. Это обязательный параметр.

[in] pType

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

[in] cbData

Задает размер данных в pvData в байтах. Это обязательный параметр.

[in] pvData

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

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

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

Код возврата Описание
E_INVALIDARG
Один из параметров недопустим.
PEER_E_CONNECTION_NOT_FOUND
Не удается найти подключение с идентификатором, указанным в ullConnectionId .
 

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Комментарии

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

Требования

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

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

PeerGroupCloseDirectConnection

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupOpenDirectConnection