Função PeerCollabInviteContact (p2p.h)
A função PeerCollabInviteContact envia um convite para ingressar uma atividade de colaboração de pares em um contato confiável. Essa chamada é síncrona e, se bem-sucedida, obtém uma resposta do contato.
Sintaxe
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
Ponteiro para uma estrutura PEER_CONTACT que contém as informações de contato associadas ao convidado.
[in] pcEndpoint
Ponteiro para uma estrutura PEER_ENDPOINT que contém informações sobre o par convidado. Esse par recebe um convite quando essa API é chamada.
[in] pcInvitation
Ponteiro para uma estrutura PEER_INVITATION que contém a solicitação de convite para enviar para os pontos de extremidade especificados em pcEndpoint. Esse parâmetro não deve ser definido como NULL.
[out] ppResponse
Ponteiro para uma estrutura PEER_INVITATION_RESPONSE que recebe as respostas de um ponto de extremidade par convidado para a solicitação de convite.
Se essa chamada falhar com um erro, esse parâmetro será NULL.
Libere a memória retornada chamando PeerFreeData.
Retornar valor
Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Não há memória suficiente para dar suporte a essa operação. |
|
Um dos argumentos é inválido. |
|
O destinatário do convite não respondeu dentro de 5 minutos. |
Comentários
Essa API garante que o par que recebe o convite seja o contato especificado como entrada. A conexão falhará se o contato específico não estiver presente no ponto de extremidade especificado. O uso de PeerCollabInviteContact é recomendado no lugar do PeerCollabInviteEndpoint menos seguro.
Uma notificação do sistema será exibida para o destinatário do convite. Essa notificação do sistema será convertida em uma caixa de diálogo na qual o usuário pode aceitar ou recusar o convite. Quando o convite é aceito com êxito, o aplicativo colaborativo é iniciado no computador do destinatário.
Para receber o convite com êxito, o aplicativo deve ser registrado no computador do destinatário usando PeerCollabRegisterApplication. Também é possível que o remetente do convite tenha códigos de falha retornados porque o destinatário desativou os convites do aplicativo.
Se o destinatário estiver aceitando convites somente de contatos confiáveis, o remetente do convite deverá ser adicionado ao repositório de contatos do computador destinatário. O remetente deve ser adicionado ao repositório de contatos antes da tentativa de convite. Para adicionar um contato ao repositório de contatos, chame PeerCollabAddContact.
O destinatário do convite deve responder dentro de 5 minutos para evitar o tempo limite.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |