共用方式為


PeerCollabEnumEndpoints 函式 (p2p.h)

PeerCollabEnumEndpoints 函式會將句柄傳回列舉,其中包含與特定對等聯繫人相關聯的端點。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
  [in]  PCPEER_CONTACT pcContact,
  [out] HPEERENUM      *phPeerEnum
);

參數

[in] pcContact

包含特定對等聯繫人資訊的 PEER_CONTACT 結構的指標。 此參數不得為 NULL

[out] phPeerEnum

指向與所提供對等聯繫人相關聯之端點集合之句柄的指標。 將此句柄傳遞至 PeerGetNextItem ,以取得列舉集中的每個專案。

傳回值

如果函式成功,則傳回S_OK。 否則,函式會傳回下列其中一個值。

傳回碼 Description
E_OUTOFMEMORY
記憶體不足,無法支援此作業。
E_INVALIDARG
其中一個自變數無效。
PEER_E_NOT_INITIALIZED
Windows 對等基礎結構未初始化。 需要呼叫相關的初始化函式。
PEER_E_NOT_SIGNED_IN
作業需要使用者登入。

備註

建議您先使用 PeerCollabUpdateContact 更新 聯繫人記錄,再呼叫 PeerCollabEnumEndpoints。 無法這麼做可能會導致傳回E_INVALIDARG。

端點僅適用於 fWatch 設定為 true 的連絡人。 只有呼叫端對等的「我」聯繫人已儲存為信任聯繫人且 將 WatcherPermissions 設為 允許 的端點可供使用。 聯繫人也必須登入因特網。 如果連絡人未登入,則會傳回錯誤 E_INVALIDARG

若要取得個別對等端點,請將傳回的句柄傳遞至 PeerGetNextItem。 將會傳回 PEER_ENDPOINT 結構的指標陣列。 如果沒有可用的端點,則會傳回空陣列。 若要關閉列舉並釋放與其相關聯的資源,請將此句柄傳遞至 PeerEndEnumeration。 列舉傳回的個別項目必須使用 PeerFreeData 來釋放。

單一聯繫人的連線限制為50。

規格需求

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

另請參閱

PEER_ENDPOINT

對等共同作業 API 函式