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 メソッドを呼び出す必要があります。
呼び出し元は、このメソッドが正常に完了するためにコラボレーション インフラストラクチャにサインインする必要はありませんが、呼び出し元が以前にサインインしている間に、 RefreshData またはいずれかの Subscribe メソッドの呼び出しが正常に完了している必要があります。
注意 (呼び出し元)
サブクラスの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 メソッドを呼び出す必要があります。
呼び出し元は、このメソッドが正常に完了するためにコラボレーション インフラストラクチャにサインインする必要はありませんが、呼び出し元が以前にサインインしている間に、 RefreshData またはいずれかの Subscribe メソッドの呼び出しが正常に完了している必要があります。
注意 (呼び出し元)
サブクラスのPeerとPeerContactの代わりに、PeerNearMe クラスに追加のオーバーロードが定義されます。
このメソッドを呼び出す場合は、PermissionStateのUnrestrictedが必要です。 この状態は、ピア コラボレーション セッションの開始時に作成されます。