PeerCollabRefreshEndpointData 函数 (p2p.h)

  • 项目

PeerCollabRefreshEndpointData 函数使用新的终结点数据更新调用对等节点。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
  [in] PCPEER_ENDPOINT pcEndpoint
);

parameters

[in] pcEndpoint

指向 PEER_ENDPOINT 结构的指针，该结构包含当前对等节点的更新的对等终结点信息。

返回值

如果函数成功，则返回S_OK。 否则，函数将返回以下值之一。

返回代码 说明
E_OUTOFMEMORY
 没有足够的内存来支持此操作。
E_INVALIDARG
 其中一个参数无效。

注解

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

请参阅

PEER_ENDPOINT

对等协作 API 函数

PeerCollabEnumApplications

PeerCollabEnumObjects

PeerCollabGetPresenceInfo