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。 否则，函数将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
没有足够的内存来支持此操作。 |
|
其中一个参数无效。 |
|
请求的联系人数据不存在。 在再次尝试之前，请尝试调用 PeerCollabRefreshEndpointData 。 |
注解
若要成功检索终结点的联系人数据，必须执行以下任一操作：
- 该终结点必须以前通过调用 PeerCollabEnumEndpoints 获取。
- 本地对等方必须通过调用 PeerCollabSubscribeEndpointData 订阅了终结点。
- 必须通过成功调用 PeerCollabRefreshEndpointData 来刷新终结点数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |