共用方式為


Peer.GetObjects 方法

定義

從本機快取中,取得對等電腦所註冊之資料物件的集合。

多載

GetObjects()

取得本機快取中資料物件的集合。

GetObjects(Guid)

Peer 中,取得與提供的 Guid 相關聯的 PeerObjectCollection 物件。

備註

這項功能只會在類別上 PeerContact 公開。 基於安全性考慮,這項功能不會在其他類型的對等上公開。

如果找不到端點的物件,則會傳回大小為 0 (0) 的集合。

GetObjects()

取得本機快取中資料物件的集合。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects();
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects ();
[<System.Security.SecurityCritical>]
member this.GetObjects : unit -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

傳回

這個執行個體所指定的對等電腦或端點的 PeerObject 集合。

屬性

例外狀況

呼叫端未訂閱端點,或尚未呼叫 RefreshData()

這個方法無法完成,因為基礎對等共同作業基礎結構中發生錯誤。

備註

這項功能只會在類別上 PeerContact 公開。 基於安全性考慮,這項功能不會在其他類型的對等上公開。

如果對等共同作業會話未使用 PermissionStateUnrestricted具現化,這個方法就無法存取本機計算機上的物件。 在共同作業會話中註冊的應用程式也是如此。

對等物件的集合包含應用程式、數據物件,以及這個實例所指定之對等或端點的狀態資訊。 如果找不到端點的物件,則會傳回大小為 0 (0) 的集合。 如果呼叫對等已訂閱此端點,則會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。

呼叫端不需要登入共同作業基礎結構,此方法才能順利完成。 在呼叫端先前登入呼叫此方法時,必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData

注意:類別上定義了其他多載, Peer 而不是子類別 PeerContactPeerNearMe

另請參閱

適用於

GetObjects(Guid)

Peer 中,取得與提供的 Guid 相關聯的 PeerObjectCollection 物件。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(Guid objectId);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (Guid objectId);
[<System.Security.SecurityCritical>]
member this.GetObjects : Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (objectId As Guid) As PeerObjectCollection

參數

objectId
Guid

PeerGuid從集合中擷取之物件的 。

傳回

與提供的 Peer 相關聯的 Guid。 如果找不到物件,就會傳回大小為零 (0) 的集合。

屬性

例外狀況

物件 ID 為 null

呼叫端未訂閱 PeerEndPoint,或尚未對它呼叫 RefreshData()

從對等電腦擷取物件資訊時發生錯誤。

備註

這項功能只會在類別上 PeerContact 公開。 基於安全性考慮,這項功能不會在其他類型的對等上公開。

對等物件的集合包含應用程式、數據物件,以及這個實例所指定之對等或端點的狀態資訊。 如果找不到端點的物件,則會傳回大小為 0 (0) 的集合。 當呼叫對等訂閱此端點時,會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。

呼叫端不需要登入共同作業基礎結構,此方法才能順利完成。 在呼叫端先前登入呼叫此方法時,必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。 呼叫這個方法需要 PermissionStateUnrestricted。 當共同作業會話開始時,就會建立此狀態。

注意:類別上會定義其他多載, Peer 而不是衍生類別 PeerContactPeerNearMe

另請參閱

適用於