Función PeerCollabAddContact (p2p.h)

La función PeerCollabAddContact agrega un contacto a la lista de contactos de un mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
  [in]            PCWSTR        pwzContactData,
  [out, optional] PPEER_CONTACT *ppContact
);

Parámetros

[in] pwzContactData

Puntero a un búfer de cadena Unicode terminado en cero que contiene los datos de contacto del mismo nivel que se agregan a la lista de contactos. Este búfer de cadena se puede obtener pasando el nombre del mismo nivel del punto de conexión que se va a agregar como un contacto a PeerCollabQueryContactData o a través de un mecanismo fuera de banda.

Para enviar sus propios datos de contacto fuera de banda, el elemento del mismo nivel puede llamar a PeerCollabExportContact con un nombre del mismo nivel NULL . Esta función devuelve los datos de contacto en formato XML.

[out, optional] ppContact

Puntero a un puntero a una estructura de PEER_CONTACT . Este parámetro recibe la dirección de una estructura de PEER_CONTACT que contiene información de contacto del mismo nivel para el contacto proporcionado en pwzContactData. Este parámetro puede ser NULL.

Llame a PeerFreeData en la dirección de la estructura de PEER_CONTACT para liberar estos 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.

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_CONTACT

Funciones de API de colaboración del mismo nivel

PeerCollabExportContact

PeerCollabQueryContactData