PeerCollabRefreshEndpointData 函数 (p2p.h)

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

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
  [in] PCPEER_ENDPOINT pcEndpoint
);

参数

[in] pcEndpoint

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

返回值

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

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

注解

PeerCollabRefreshEndpointData 允许应用程序刷新与终结点关联的数据。 API 完成后,将引发PEER_EVENT_REQUEST_STATUS_CHANGED事件。 该事件将包含成功或失败代码。

成功后,应用程序可以调用 PeerCollabGetPresenceInfoPeerCollabEnumApplicationsPeerCollabEnumObjectsPeerCollabQueryContactData 等函数来获取其他数据。 当不再需要数据时,可以通过调用 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

另请参阅

PEER_ENDPOINT

对等协作 API 函数

PeerCollabEnumApplications

PeerCollabEnumObjects

PeerCollabGetPresenceInfo