PeerCollabAddContact 函数 (p2p.h)

  • 项目

PeerCollabAddContact 函数将联系人添加到对等方的联系人列表中。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
  [in]            PCWSTR        pwzContactData,
  [out, optional] PPEER_CONTACT *ppContact
);

parameters

[in] pwzContactData

指向零终止的 Unicode 字符串缓冲区的指针，该缓冲区包含添加到联系人列表的对等方的联系人数据。 可以通过将终结点的对等名称作为联系人添加到 PeerCollabQueryContactData 或通过带外机制来获取此字符串缓冲区。

若要在带外发送自己的联系人数据，对等方可以使用 NULL 对等名称调用 PeerCollabExportContact。 此函数返回 XML 格式的联系人数据。

[out, optional] ppContact

指向 指向PEER_CONTACT 结构的指针的指针。 此参数接收包含 pwzContactData 中提供的联系人的对等联系人信息的PEER_CONTACT结构的地址。 此参数可以为 NULL。

在PEER_CONTACT结构的地址上调用 PeerFreeData 以释放此数据。

返回值

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

返回代码 说明
E_OUTOFMEMORY
 没有足够的内存来支持此操作。
E_INVALIDARG
 其中一个参数无效。

要求

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

请参阅

PEER_CONTACT

对等协作 API 函数

PeerCollabExportContact

PeerCollabQueryContactData