Funzione PeerCollabRefreshEndpointData (p2p.h)
La funzione PeerCollabRefreshEndpointData aggiorna il nodo peer chiamante con nuovi dati dell'endpoint.
Sintassi
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
Parametri
[in] pcEndpoint
Puntatore a una struttura PEER_ENDPOINT che contiene le informazioni sull'endpoint peer aggiornato per il nodo peer corrente.
Valore restituito
Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente per supportare questa operazione. |
|
Uno degli argomenti non è valido. |
Commenti
PeerCollabRefreshEndpointData consente a un'applicazione di aggiornare i dati associati all'endpoint. Al termine dell'API, verrà generato l'evento PEER_EVENT_REQUEST_STATUS_CHANGED. L'evento conterrà un codice di esito positivo o negativo.
In caso di esito positivo, l'applicazione può chiamare funzioni come PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects e PeerCollabQueryContactData per ottenere dati aggiuntivi. Quando i dati non sono più necessari, è possibile eliminarli chiamando PeerCollabDeleteEndpointData.
Se un peer viene sottoscritto all'endpoint, i dati sottoscritti hanno una precedenza maggiore rispetto ai dati memorizzati nella cache chiamando PeerCollabRefreshEndpointDataand restituiranno PEER_EVENT_REQUEST_STATUS_CHANGED.
L'API PeerCollabRefreshEndpointData accetta uno snapshot dei dati per l'endpoint specificato. Se i dati dell'endpoint vengono modificati dopo l'acquisizione di questo snapshot, il chiamante avrà una copia non aggiornata dei dati. Se PeerCollabRefreshEndpointData viene chiamato da un'applicazione più volte per lo stesso endpoint, i dati più recenti ricevuti sostituisce i dati archiviati da una chiamata precedente all'API. Tuttavia, per assicurarsi che il chiamante riceva una notifica di eventuali modifiche e abbia sempre la copia più recente, PeerCollabSubscribeEndpointData è consigliato anziché PeerCollabRefreshEndpointData.
La funzione PeerCollabRefreshEndpointData verrà timeout a 30 secondi.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | p2p.h |
| Libreria | P2P.lib |
| DLL | P2P.dll |