Función PeerCollabInviteContact (p2p.h)
La función PeerCollabInviteContact envía una invitación para unirse a una actividad de colaboración del mismo nivel a un contacto de confianza. Esta llamada es sincrónica y, si se ejecuta correctamente, obtiene una respuesta del contacto.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabInviteContact(
[in] PCPEER_CONTACT pcContact,
[in] PCPEER_ENDPOINT pcEndpoint,
[in] PCPEER_INVITATION pcInvitation,
[out] PPEER_INVITATION_RESPONSE *ppResponse
);
Parámetros
[in] pcContact
Puntero a una estructura de PEER_CONTACT que contiene la información de contacto asociada al invitado.
[in] pcEndpoint
Puntero a una estructura de PEER_ENDPOINT que contiene información sobre el elemento del mismo nivel invitado. Este elemento del mismo nivel se envía una invitación cuando se llama a esta API.
[in] pcInvitation
Puntero a una estructura de PEER_INVITATION que contiene la solicitud de invitación para enviar a los puntos de conexión especificados en pcEndpoint. Este parámetro no debe establecerse en NULL.
[out] ppResponse
Puntero a una estructura de PEER_INVITATION_RESPONSE que recibe las respuestas de un punto de conexión del mismo nivel invitado a la solicitud de invitación.
Si se produce un error en esta llamada, este parámetro será NULL.
Libere la memoria devuelta llamando a PeerFreeData.
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. |
|
El destinatario de la invitación no ha respondido en un plazo de 5 minutos. |
Comentarios
Esta API garantiza que el elemento del mismo nivel que recibe la invitación sea el contacto especificado como entrada. Se producirá un error en la conexión si el contacto específico no está presente en el punto de conexión especificado. El uso de PeerCollabInviteContact se recomienda en lugar de PeerCollabInviteEndpoint menos seguro.
Aparecerá una notificación del sistema para el destinatario de la invitación. Esta notificación del sistema se convertirá en un cuadro de diálogo en el que el usuario puede aceptar o rechazar la invitación. Cuando la invitación se acepta correctamente, la aplicación colaborativa se inicia en el equipo del destinatario.
Para recibir correctamente la invitación, la aplicación debe registrarse en el equipo del destinatario mediante PeerCollabRegisterApplication. También es posible que el remitente de la invitación devuelva códigos de error porque el destinatario ha desactivado las invitaciones a la aplicación.
Si el destinatario acepta invitaciones solo de contactos de confianza, el remitente de la invitación debe agregarse al almacén de contactos del equipo del destinatario. El remitente debe agregarse al almacén de contactos antes del intento de invitación. Para agregar un contacto al almacén de contactos, llame a PeerCollabAddContact.
El destinatario de la invitación debe responder en un plazo de 5 minutos para evitar el tiempo de espera.
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 |