Función PeerCollabQueryContactData (p2p.h)

La función PeerCollabQueryContactData recupera la información de contacto del punto de conexión del mismo nivel proporcionado.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

Parámetros

[in, optional] pcEndpoint

Puntero a una estructura de PEER_ENDPOINT que contiene el punto de conexión del mismo nivel sobre el que obtener información de contacto.

Si este parámetro se establece en NULL, se obtiene la información de contacto del punto de conexión del mismo nivel actual.

[out] ppwzContactData

Puntero a un búfer de cadena Unicode terminado en cero que contiene los datos de contacto del punto de conexión proporcionado en pcEndpoint. Llame a PeerFreeData para liberar los datos.

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_FOUND	Los datos de contacto solicitados no existen. Intente llamar a PeerCollabRefreshEndpointData antes de realizar otro intento.

Comentarios

Para recuperar los datos de contacto de un punto de conexión correctamente, debe producirse una de las siguientes acciones:

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

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_ENDPOINT

Funciones de API de colaboración del mismo nivel