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 |
---|---|
|
記憶體不足,無法支援此作業。 |
|
其中一個自變數無效。 |
|
Windows 對等基礎結構未初始化。 需要呼叫相關的初始化函式。 |
|
作業需要使用者登入。 |
備註
建議您先使用 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 |