PeerContact.GetObjects 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得本機快取中對等物件的集合。
多載
GetObjects(PeerEndPoint) |
取得由指定的 PeerObjectCollection 所註冊並儲存在本機快取中的 PeerEndPoint。 |
GetObjects(PeerEndPoint, Guid) |
取得的對等物件集合,是由指定的 PeerEndPoint 於指定的 PeerApplication 所識別的 Guid 中註冊。 |
GetObjects(PeerEndPoint)
取得由指定的 PeerObjectCollection 所註冊並儲存在本機快取中的 PeerEndPoint。
public:
System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);
[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (peerEndPoint As PeerEndPoint) As PeerObjectCollection
參數
- peerEndPoint
- PeerEndPoint
要從中擷取物件的端點。
傳回
與指定 PeerObjectCollection 相關聯的 PeerEndPoint。 如果沒有應用程式與端點相關聯,就會傳回大小為零 (0) 的集合。
- 屬性
例外狀況
PeerEndPoint 不可以是 null
。
通叫對等未訂閱 PeerContact 與相關聯的 PeerEndPoint。
呼叫對等尚未呼叫 RefreshData() 方法。
無法完成 GetObjects 作業。
備註
如果呼叫對等未訂閱 PeerContact 與指定 PeerEndPoint 之 相關聯的 , RefreshData 則必須在呼叫這個方法之前呼叫方法。
雖然呼叫端不需要登入這個方法的共同作業基礎結構才能順利完成,但先前登入呼叫端時,必須完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。
給呼叫者的注意事項
類別上會定義其他多載, Peer 而不是子類別 PeerContact 和 PeerNearMe。
呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時,就會建立此狀態。
另請參閱
適用於
GetObjects(PeerEndPoint, Guid)
取得的對等物件集合,是由指定的 PeerEndPoint 於指定的 PeerApplication 所識別的 Guid 中註冊。
public:
System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, Guid objectId);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, Guid objectId);
[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint * Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (peerEndPoint As PeerEndPoint, objectId As Guid) As PeerObjectCollection
參數
- peerEndPoint
- PeerEndPoint
要從中擷取物件的端點。
- objectId
- Guid
要擷取之 Guid 的 PeerObject。
傳回
與指定 PeerObjectCollection 相關聯的 PeerEndPoint。 如果沒有應用程式與端點相關聯,就會傳回大小為零 (0) 的集合。
- 屬性
例外狀況
PeerEndPoint 不可以是 null
。
通話對等未訂閱 PeerEndPoint。
呼叫對等尚未呼叫 RefreshData() 方法。
無法完成 GetObjects 作業。
備註
如果呼叫對等未訂閱 PeerContact 與指定 PeerEndPoint 之 相關聯的 , RefreshData 則必須在呼叫這個方法之前呼叫方法。
雖然呼叫端不需要登入這個方法的共同作業基礎結構才能順利完成,但先前登入呼叫端時,必須完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。
給呼叫者的注意事項
類別上會定義其他多載, Peer 而不是子類別 PeerContact 和 PeerNearMe。
呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時,就會建立此狀態。