PeerCollabRefreshEndpointData, fonction (p2p.h)
La fonction PeerCollabRefreshEndpointData met à jour le nœud d’homologue appelant avec de nouvelles données de point de terminaison.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
Paramètres
[in] pcEndpoint
Pointeur vers une structure PEER_ENDPOINT qui contient les informations de point de terminaison d’homologue mises à jour pour le nœud homologue actuel.
Valeur retournée
Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La mémoire est insuffisante pour prendre en charge cette opération. |
|
L’un des arguments n’est pas valide. |
Notes
PeerCollabRefreshEndpointData permet à une application d’actualiser les données associées au point de terminaison. Une fois l’API terminée, l’événement PEER_EVENT_REQUEST_STATUS_CHANGED est déclenché. L’événement contiendra un code de réussite ou d’échec.
En cas de réussite, l’application peut appeler des fonctions telles que PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects et PeerCollabQueryContactData pour obtenir des données supplémentaires. Lorsque les données ne sont plus nécessaires, elles peuvent être supprimées en appelant PeerCollabDeleteEndpointData.
Si un homologue est abonné au point de terminaison, les données abonnées sont plus prioritaires que les données mises en cache en appelant PeerCollabRefreshEndpointData et retournent PEER_EVENT_REQUEST_STATUS_CHANGED.
L’API PeerCollabRefreshEndpointData prend une instantané des données pour le point de terminaison spécifié. Si les données de point de terminaison changent une fois cette instantané effectuée, l’appelant dispose d’une copie obsolète des données. Si PeerCollabRefreshEndpointData est appelé par une application plusieurs fois pour le même point de terminaison, les données les plus récentes reçues remplacent les données stockées à partir d’un appel antérieur à l’API. Toutefois, pour garantir que l’appelant est informé de toute modification et dispose toujours de la dernière copie, PeerCollabSubscribeEndpointData est recommandé au lieu de PeerCollabRefreshEndpointData.
La fonction PeerCollabRefreshEndpointData expire à 30 secondes.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | p2p.h |
| Bibliothèque | P2P.lib |
| DLL | P2P.dll |