peerCollabGetContact 函数 (p2p.h)

PeerCollabGetContact 函数获取给定对等联系人名称的对等联系人的信息。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
  [in, optional]  PCWSTR        pwzPeerName,
  [out, optional] PPEER_CONTACT *ppContact
);

[in, optional] pwzPeerName

指向以零结尾的 Unicode 字符串的指针，该字符串包含要为其获取信息的对等联系人的名称。

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

[out, optional] ppContact

指向指向PEER_CONTACT 结构的指针的指针。它接收PEER_CONTACT结构的地址，该结构包含 pwzPeerName 中提供的对等名称的对等联系人信息。当此参数为 NULL 时，此函数返回E_INVALIDARG。

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

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

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