Compartilhar via


Função PeerCollabCancelInvitation (p2p.h)

A função PeerCollabCancelInvitation cancela um convite enviado anteriormente pelo chamador para um contato.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabCancelInvitation(
  [in] HANDLE hInvitation
);

Parâmetros

[in] hInvitation

Manipule para um convite enviado anteriormente.

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
E_OUTOFMEMORY
Não há memória suficiente para dar suporte a essa operação.
E_INVALIDARG
O identificador fornecido é inválido.
PEER_E_NOT_INITIALIZED
O aplicativo não fez uma chamada anterior para PeerCollabStartup.
E_HANDLE
O identificador especificado é inválido.

Comentários

Quando PeerCollabCancelInvitation for chamado, dependendo do estado do convite, ele executará uma ou mais das seguintes ações:

  • Se a conexão com o receptor ainda não estiver estabelecida, ela cancelará o processo de criação da conexão e o receptor não verá o convite.
  • Se o convite tiver sido recebido, mas não tiver respondido, ele notificará o contato do destinatário de que o convite foi cancelado. Como resultado, o receptor não poderá responder ao convite.
  • Se o receptor já tiver respondido ao convite, a chamada executará uma no-op. Depois de cancelar o convite, você deve chamar PeerCollabCloseHandle.

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

Confira também

Funções da API de Colaboração de Pares

PeerCollabCloseHandle