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來刪除。
如果對等訂閱端點，則訂閱的資料優先順序高於呼叫 PeerCollabRefreshEndpointData 所快取的資料，且會 傳回PEER_EVENT_REQUEST_STATUS_CHANGED。
PeerCollabRefreshEndpointData API 會擷取指定端點的資料快照集。 如果擷取此快照集之後端點資料變更，則呼叫端會有過時的資料複本。 如果同一端點的應用程式多次呼叫 PeerCollabRefreshEndpointData，則收到的最新資料會取代先前呼叫 API 所儲存的資料。 不過，為了確保呼叫端收到任何變更的通知，且一律具有最新的複本，建議使用 PeerCollabSubscribeEndpointData ，而不是 PeerCollabRefreshEndpointData。
PeerCollabRefreshEndpointData函式會在 30 秒逾時。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |