PeerCollabSubscribeEndpointData 函数 (p2p.h)

PeerCollabSubscribeEndpointData 函数创建对可用终结点的订阅。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
  [in] const PCPEER_ENDPOINT pcEndpoint
);

[in] pcEndpoint

指向 PEER_ENDPOINT 结构的指针，该结构包含用于获取状态信息的对等终结点。

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

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

PeerCollabSubscribeEndpointData 是一个异步调用，这意味着订阅终结点的过程已启动，但此调用返回时不一定完成。应用程序应等待PEER_EVENT_REQUEST_STATUS_CHANGED获取订阅请求的结果。

此函数将在 30 秒处超时。

可以从同一终结点的不同应用程序多次调用 PeerCollabSubscribeEndpointData。对每个调用进行引用计数;仅当释放最后一个引用是取消订阅的对等时。若要释放引用，请调用 PeerCollabUnsubscribeEndpointData。

当应用程序退出而不调用 PeerCollabUnsubscribeEndpointData 时，该应用程序的所有引用都将自动释放。

若要成功调用 PeerCollabGetPresenceInfo、 PeerCollabEnumApplications、 PeerCollabEnumObjects 和 PeerCollabQueryContactData API，应用程序必须首先调用 PeerCollabSubscribeEndpointData。