Función PeerCollabInviteContact (p2p.h)

  • Artículo

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
E_OUTOFMEMORY
 No hay suficiente memoria para admitir esta operación.
E_INVALIDARG
 Uno de los argumentos no es válido.
PEER_E_TIMEOUT
 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

Consulte también

PEER_CONTACT

PEER_ENDPOINT

PEER_INVITATION

PEER_INVITATION_RESPONSE

PeerCollabGetAppLaunchInfo