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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GROUP_EVENT_DATA *ppEventData
);

Параметры

[in] hPeerEvent

Дескриптор, полученный при предыдущем вызове PeerGroupRegisterEvent. Это обязательный параметр.

[out] ppEventData

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

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

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

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
PEER_S_NO_EVENT_DATA
 Вызов выполнен успешно, но нет доступных данных о событиях.
 

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

Комментарии

При возникновении события, для которого одноранговый узел запросил уведомление, сигнализирует соответствующий дескриптор события однорангового узла. Одноранговый узел вызывает этот метод, пока не будут получены PEER_GROUP_EVENT_DATA структуры. Каждая структура данных содержит следующие два ключевых элемента данных:

  • Регистрация, связанная с событием однорангового узла.
  • Фактические данные для однорангового события.

Требования

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

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

PEER_GROUP_EVENT_DATA

PeerFreeData

PeerGroupRegisterEvent