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
E_OUTOFMEMORY	No hay suficiente memoria para admitir esta operación.
E_INVALIDARG	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

Consulte también

PEER_ENDPOINT

Funciones de API de colaboración del mismo nivel

PeerCollabEnumApplications

PeerCollabEnumObjects

PeerCollabGetPresenceInfo