Función PeerCollabAddContact (p2p.h)

La función PeerCollabAddContact agrega un contacto a la lista de contactos de un elemento del 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 cadenas 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 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 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