PeerGroupGetEventData 函数 (p2p.h)
PeerGroupGetEventData 函数允许应用程序检索分组事件返回的数据。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetEventData(
[in] HPEEREVENT hPeerEvent,
[out] PPEER_GROUP_EVENT_DATA *ppEventData
);
parameters
[in] hPeerEvent
从上一次调用 PeerGroupRegisterEvent 获取的句柄。 此参数是必需的。
[out] ppEventData
指向包含对等事件数据的 PEER_GROUP_EVENT_DATA 结构的指针。 与 PeerFreeData 一起使用后，必须释放此数据结构。 此参数是必需的。
返回值
如果操作成功，则返回 S_OK 。 否则，函数将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
其中一个参数无效。 |
|
调用成功，但没有可用的事件数据。 |
可以从 Microsoft RSA 基本提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。
注解
当发生对等方已请求通知的事件时，会向相应的对等事件句柄发出信号。 对等方调用此方法，直到检索 到PEER_GROUP_EVENT_DATA 结构。 每个数据结构包含以下两个关键数据片段：
- 与对等事件关联的注册。
- 对等事件的实际数据。
要求
| 最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |