PeerContact.GetObjects メソッド

定義

名前空間:

System.Net.PeerToPeer.Collaboration

アセンブリ:

System.Net.dll

ピア オブジェクトのコレクションをローカル キャッシュから取得します。

オーバーロード

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

指定した PeerObjectCollection に関連付けられている PeerEndPoint。 アプリケーションがエンドポイントに関連付けられていない場合、サイズがゼロ (0) のコレクションが返されます。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint として null を使用することはできません。

InvalidOperationException

• 呼び出し元のピアは、 に関連付PeerEndPointけられている にPeerContactサブスクライブされていません。

• 呼び出し元ピアは、 メソッドを RefreshData() まだ呼び出していません。

PeerToPeerException

GetObjects 操作を完了できません。

注釈

呼び出し元のピアが、指定した PeerEndPoint に関連付けられている をPeerContactサブスクライブしていない場合は、RefreshDataこのメソッドを呼び出す前にメソッドを呼び出す必要があります。

このメソッドが正常に完了するには、呼び出し元がコラボレーション インフラストラクチャにサインインする必要はありませんが、呼び出し元が以前にサインインしている間に RefreshData 、 または いずれかのメソッドの Subscribe 呼び出しが正常に完了している必要があります。

注意 (呼び出し元)

サブクラスPeerContactと PeerNearMeの代わりに、 Peer クラスに対して追加のオーバーロードが定義されます。

このメソッドを呼び出す場合は、 の UnrestrictedがPermissionState必要です。 この状態は、ピア コラボレーション セッションの開始時に作成されます。

こちらもご覧ください

• PeerChangeType
• PeerScope

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

指定した PeerObjectCollection に関連付けられている PeerEndPoint。 アプリケーションがエンドポイントに関連付けられていない場合、サイズがゼロ (0) のコレクションが返されます。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint として null を使用することはできません。

InvalidOperationException

• 呼び出し元のピアは、 PeerEndPointにサブスクライブされていません。

• 呼び出し元ピアは、 メソッドを RefreshData() まだ呼び出していません。

PeerToPeerException

GetObjects 操作を完了できません。

注釈

呼び出し元のピアが、指定した PeerEndPoint に関連付けられている をPeerContactサブスクライブしていない場合は、RefreshDataこのメソッドを呼び出す前にメソッドを呼び出す必要があります。

このメソッドが正常に完了するには、呼び出し元がコラボレーション インフラストラクチャにサインインする必要はありませんが、呼び出し元が以前にサインインしている間に RefreshData 、 または いずれかのメソッドの Subscribe 呼び出しが正常に完了している必要があります。

注意 (呼び出し元)

サブクラスPeerContactと PeerNearMeの代わりに、 Peer クラスに対して追加のオーバーロードが定義されます。

このメソッドを呼び出す場合は、 の UnrestrictedがPermissionState必要です。 この状態は、ピア コラボレーション セッションの開始時に作成されます。

こちらもご覧ください

• PeerChangeType
• PeerScope