PeerCollabRefreshEndpointData 函数 (p2p.h)
PeerCollabRefreshEndpointData 函数使用新的终结点数据更新调用对等节点。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
parameters
[in] pcEndpoint
指向 PEER_ENDPOINT 结构的指针，该结构包含当前对等节点的更新的对等终结点信息。
返回值
如果函数成功，则返回S_OK。 否则，函数将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
没有足够的内存来支持此操作。 |
|
其中一个参数无效。 |
注解
PeerCollabRefreshEndpointData 允许应用程序刷新与终结点关联的数据。 API 完成后，将引发PEER_EVENT_REQUEST_STATUS_CHANGED事件。 事件将包含成功或失败代码。
成功后，应用程序可以调用 PeerCollabGetPresenceInfo、 PeerCollabEnumApplications、 PeerCollabEnumObjects 和 PeerCollabQueryContactData 等函数来获取其他数据。 不再需要数据时，可以通过调用 PeerCollabDeleteEndpointData 将其删除。
如果对等方订阅了终结点，则订阅的数据的优先级高于通过调用 PeerCollabRefreshEndpointData 缓存的数据，并将返回 PEER_EVENT_REQUEST_STATUS_CHANGED。
PeerCollabRefreshEndpointData API 获取指定终结点的数据快照。 如果在执行此快照后终结点数据发生更改，则调用方将拥有过时的数据副本。 如果应用程序针对同一终结点多次调用 PeerCollabRefreshEndpointData，则接收的最新数据将替换之前调用 API 时存储的数据。 但是，为了确保调用方收到任何更改通知并始终具有最新副本，建议使用 PeerCollabSubscribeEndpointData 而不是 PeerCollabRefreshEndpointData。
PeerCollabRefreshEndpointData 函数将在 30 秒时超时。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |