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