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 |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
Uno de los argumentos no es válido. |
|
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 |