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

傳回碼	Description
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。