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 |
|---|---|
|
No hay suficiente memoria para admitir esta operación. |
|
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 |