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指向的数据结构的类型取决于触发的事件。

要求

要求
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用],带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

另请参阅

PEER_GRAPH_EVENT_DATA

PeerGraphFreeData

PeerGraphRegisterEvent

PeerGraphUnregisterEvent