PeerCollabGetPresenceInfo 函数 (p2p.h)

PeerCollabGetPresenceInfo 函数检索与特定联系人关联的终结点的状态信息。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetPresenceInfo(
  [in]  PCPEER_ENDPOINT     pcEndpoint,
  [out] PPEER_PRESENCE_INFO *ppPresenceInfo
);

参数

[in] pcEndpoint

指向 PEER_ENDPOINT 结构的指针，该结构包含与 pcContact 中指定的联系人关联的特定终结点，必须为其返回状态信息。

[out] ppPresenceInfo

指向 PEER_PRESENCE_INFO 结构的地址的指针，该结构包含所请求的终结点的状态数据。

返回值

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

返回代码	说明
E_OUTOFMEMORY	没有足够的内存来支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	应用程序之前没有调用 PeerCollabStartup。
PEER_E_NOT_FOUND	在对等协作网络中找不到指定终结点的状态信息。

注解

若要成功获取对等对象，请执行：

• 该终结点必须以前通过调用 PeerCollabEnumEndpoints 获取。
• 本地对等方必须通过调用 PeerCollabSubscribeEndpointData 订阅了终结点。
• 必须通过成功调用 PeerCollabRefreshEndpointData 来刷新终结点数据。

要求

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

另请参阅

PEER_CONTACT

PEER_ENDPOINT

PEER_PRESENCE_INFO

对等协作 API 函数