Función PeerCollabRefreshEndpointData (p2p.h)
La función PeerCollabRefreshEndpointData actualiza el nodo del mismo nivel que llama con nuevos datos de punto de conexión.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
Parámetros
[in] pcEndpoint
Puntero a una estructura de PEER_ENDPOINT que contiene la información actualizada del punto de conexión del mismo nivel para el nodo del mismo nivel actual.
Valor devuelto
Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
Uno de los argumentos no es válido. |
Comentarios
PeerCollabRefreshEndpointData permite a una aplicación actualizar los datos asociados al punto de conexión. Tras la finalización de la API, se generará el evento PEER_EVENT_REQUEST_STATUS_CHANGED. El evento contendrá un código correcto o de error.
Si la aplicación se ejecuta correctamente, puede llamar a funciones como PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects y PeerCollabQueryContactData para obtener datos adicionales. Cuando los datos ya no sean necesarios, se pueden eliminar llamando a PeerCollabDeleteEndpointData.
Si un elemento del mismo nivel está suscrito al punto de conexión, los datos suscritos tienen mayor prioridad que los datos almacenados en caché mediante una llamada a PeerCollabRefreshEndpointDataand devolverán PEER_EVENT_REQUEST_STATUS_CHANGED.
La API PeerCollabRefreshEndpointData toma una instantánea de los datos del punto de conexión especificado. Si los datos del punto de conexión cambian después de tomar esta instantánea, el autor de la llamada tendrá una copia obsoleta de los datos. Si una aplicación llama varias veces a PeerCollabRefreshEndpointData para el mismo punto de conexión, los datos más recientes recibidos reemplazan los datos almacenados de una llamada anterior a la API. Sin embargo, para asegurarse de que el autor de la llamada recibe una notificación de los cambios y siempre tiene la copia más reciente, se recomienda PeerCollabSubscribeEndpointData en lugar de PeerCollabRefreshEndpointData.
La función PeerCollabRefreshEndpointData expirará en 30 segundos.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | p2p.h |
| Library | P2P.lib |
| Archivo DLL | P2P.dll |