Función PeerCollabGetPresenceInfo (p2p.h)

La función PeerCollabGetPresenceInfo recupera la información de presencia del punto de conexión asociado a un contacto específico.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetPresenceInfo(
  [in]  PCPEER_ENDPOINT     pcEndpoint,
  [out] PPEER_PRESENCE_INFO *ppPresenceInfo
);

Parámetros

[in] pcEndpoint

Puntero a una estructura de PEER_ENDPOINT que contiene el extremo específico asociado al contacto especificado en pcContact para el que se debe devolver la información de presencia.

[out] ppPresenceInfo

Puntero a la dirección de la estructura PEER_PRESENCE_INFO que contiene los datos de presencia solicitados para el punto de conexión proporcionado.

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.
PEER_E_NOT_INITIALIZED	La aplicación no realizó una llamada anterior a PeerCollabStartup.
PEER_E_NOT_FOUND	La información de presencia del punto de conexión especificado no se encontró en la red de colaboración del mismo nivel.

Comentarios

Para obtener un objeto del mismo nivel correctamente:

• El punto de conexión debe haberse obtenido previamente llamando a PeerCollabEnumEndpoints.
• El elemento del mismo nivel local debe haberse suscrito al punto de conexión llamando a PeerCollabSubscribeEndpointData.
• Los datos del punto de conexión se deben actualizar llamando correctamente a PeerCollabRefreshEndpointData .

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

PEER_CONTACT

PEER_ENDPOINT

PEER_PRESENCE_INFO

Funciones de API de colaboración del mismo nivel