PeerCollabExportContact 函数 (p2p.h)

PeerCollabExportContact 函数将与对等名称关联的联系人数据导出到字符串缓冲区。缓冲区包含 XML 格式的联系人数据。

PeerCollabAddContact 函数允许其他对等方使用此 XML 字符串。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

[in, optional] pwzPeerName

指向以零结尾的 Unicode 字符串的指针，该字符串包含要导出的对等联系人的名称。

如果此参数为 NULL，则导出调用对等方的“Me”联系信息。

[out, optional] ppwzContactData

指向以零结尾的字符串缓冲区的指针，该缓冲区包含对等互连 XML 数据，其中对等名称与 pwzPeerName 中提供的字符串匹配。

可以通过调用 PeerFreeData 来释放此处返回的内存。

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

返回代码	说明
E_OUTOFMEMORY	内存不足，无法支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	Windows 对等基础结构未初始化。需要调用相关的初始化函数。
PEER_E_NOT_SIGNED_IN	其中一个参数无效。