PeerCollabQueryContactData 函数 (p2p.h)

PeerCollabQueryContactData 函数检索提供的对等终结点的联系信息。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

参数

[in, optional] pcEndpoint

指向 PEER_ENDPOINT 结构的指针,该结构包含要获取联系人信息的对等终结点。

如果此参数设置为 NULL,则获取当前对等终结点的联系信息。

[out] ppwzContactData

指向零端 Unicode 字符串缓冲区的指针,该缓冲区包含 pcEndpoint 中提供的终结点的联系人数据。 调用 PeerFreeData 以释放数据。

返回值

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

返回代码 说明
E_OUTOFMEMORY
没有足够的内存来支持此操作。
E_INVALIDARG
其中一个参数无效。
PEER_E_NOT_FOUND
请求的联系人数据不存在。 在再次尝试之前,请尝试调用 PeerCollabRefreshEndpointData

注解

若要成功检索终结点的联系人数据,必须执行以下任一操作:

要求

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

另请参阅

PEER_ENDPOINT

对等协作 API 函数