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。 否則，函式會傳回下列其中一個值。

傳回碼	Description
E_OUTOFMEMORY	記憶體不足，無法支援此作業。
E_INVALIDARG	其中一個自變數無效。
PEER_E_NOT_INITIALIZED	應用程式未對 PeerCollabStartup 進行先前的呼叫。
PEER_E_NOT_FOUND	在對等共同作業網路中找不到指定端點的目前狀態資訊。

備註

若要成功取得對等物件：

• 必須先呼叫 PeerCollabEnumEndpoints 來取得端點。
• 本機對等必須已呼叫 PeerCollabSubscribeEndpointData 來訂閱端點。
• 端點數據必須成功呼叫 PeerCollabRefreshEndpointData 來重新整理。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	p2p.h
程式庫	P2P.lib
Dll	P2P.dll

另請參閱

PEER_CONTACT

PEER_ENDPOINT

PEER_PRESENCE_INFO

對等共同作業 API 函式