Función PeerCollabSubscribeEndpointData (p2p.h)

La función PeerCollabSubscribeEndpointData crea una suscripción a un punto de conexión disponible.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
  [in] const PCPEER_ENDPOINT pcEndpoint
);

Parámetros

[in] pcEndpoint

Puntero a una estructura de PEER_ENDPOINT que contiene el punto de conexión del mismo nivel utilizado para obtener información de presencia.

Valor devuelto

Devuelve S_OK o PEER_S_SUBSCRIPTION_EXISTS 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.
PEER_E_NOT_INITIALIZED	La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente.

Comentarios

PeerCollabSubscribeEndpointData es una llamada asincrónica, lo que significa que el proceso para suscribirse al punto de conexión se ha iniciado, pero no se ha completado necesariamente cuando se devuelve esta llamada. Una aplicación debe esperar a que PEER_EVENT_REQUEST_STATUS_CHANGED obtenga el resultado de la solicitud de suscripción.

Esta función expirará en 30 segundos.

PeerCollabSubscribeEndpointData se puede llamar varias veces desde aplicaciones diferentes para el mismo punto de conexión. Cada llamada es referencia contada; solo cuando se publica la última referencia es un elemento del mismo nivel que se cancela la suscripción. Para liberar la llamada de referencia PeerCollabUnsubscribeEndpointData.

Cuando una aplicación sale sin llamar a PeerCollabUnsubscribeEndpointData, todas las referencias de esa aplicación se liberan automáticamente.

Para llamar correctamente a las API PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects y PeerCollabQueryContactData , una aplicación primero debe llamar a PeerCollabSubscribeEndpointData.

Requisitos

Requisito	Value
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

PeerCollabEnumApplications

PeerCollabEnumObjects

PeerCollabGetPresenceInfo

PeerCollabQueryContactData

PeerCollabUnsubscribeEndpointData