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	在对等协作网络中找不到指定终结点的状态信息。

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