PeerCollabCancelInvitation 函数 (p2p.h)

PeerCollabCancelInvitation 函数取消调用方以前发送给联系人的邀请。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabCancelInvitation(
  [in] HANDLE hInvitation
);

参数

[in] hInvitation

以前发送的邀请的句柄。

返回值

如果函数成功,则返回S_OK。 否则,该函数返回以下值之一。

返回代码 说明
E_OUTOFMEMORY
内存不足,无法支持此操作。
E_INVALIDARG
提供的句柄无效。
PEER_E_NOT_INITIALIZED
应用程序之前未调用 PeerCollabStartup
E_HANDLE
指定的句柄无效。

注解

调用 PeerCollabCancelInvitation 时,它将执行以下一项或多项操作,具体取决于邀请的状态:

  • 如果尚未与接收方建立连接,它将取消连接创建过程,并且接收方将看不到邀请。
  • 如果已收到邀请但未响应,它将通知收件人联系人邀请已取消。 因此,接收方将无法响应邀请。
  • 如果接收方已响应邀请,则呼叫将执行 no-op。 取消邀请后,必须调用 PeerCollabCloseHandle

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

对等协作 API 函数

PeerCollabCloseHandle