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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GRAPH_EVENT_DATA *ppEventData
);

Параметры

[in] hPeerEvent

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

[out] ppEventData

Получает указатель на структуру PEER_GRAPH_EVENT_DATA , содержащую данные об уведомлении о событии. Если эта структура не нужна, освободите ее, вызвав PeerGraphFreeData.

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

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

Код возврата Описание
E_INVALIDARG
 Один параметр недопустим.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения указанной операции.
PEER_S_NO_EVENT_DATA
 Вызов функции завершается успешно, но данные, связанные с одноранговым событием, отсутствуют.
PEER_E_NOT_INITIALIZED
 Одноранговый граф необходимо инициализировать с помощью вызова PeerGraphStartup перед использованием этой функции.

Комментарии

Одноранговые данные событий возвращаются в PEER_GRAPH_EVENT_DATA структуре. Тип структуры данных, на которую указывает PEER_GRAPH_EVENT_DATA , зависит от того, какое событие активируется.

Требования

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

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

PEER_GRAPH_EVENT_DATA

PeerGraphFreeData

PeerGraphRegisterEvent

PeerGraphUnregisterEvent