Peer.GetObjects メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ローカル キャッシュからピアによって登録されたデータ オブジェクトのコレクションを取得します。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetObjects() |
ローカル キャッシュからデータ オブジェクトのコレクションを取得します。 |
| GetObjects(Guid) |
指定したPeerに関連付けられたGuid オブジェクトをPeerObjectCollectionから取得します。 |
注釈
この機能は、 PeerContact クラスでのみ公開されます。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。
エンドポイントのオブジェクトが見つからない場合は、サイズ 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.PeerObjectCollectionPublic Function GetObjects () As PeerObjectCollection返品
このインスタンスで指定されたピアまたはエンドポイントの PeerObject コレクション。
- 属性
例外
呼び出し元がエンドポイントにサブスクライブされていないか、 RefreshData()をまだ呼び出していません。
基になるピア コラボレーション インフラストラクチャでエラーが発生したため、メソッドを完了できません。
注釈
この機能は、 PeerContact クラスでのみ公開されます。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。
ピア コラボレーション セッションがPermissionStateのUnrestrictedでインスタンス化されなかった場合、このメソッドはローカル コンピューター上のオブジェクトにアクセスできません。 同じことが、コラボレーション セッションに登録されているアプリケーションにも当てはまります。
ピア オブジェクトのコレクションは、このインスタンスで指定されたピアまたはエンドポイントのアプリケーション、データ オブジェクト、およびプレゼンス情報で構成されます。 エンドポイントのオブジェクトが見つからない場合は、サイズ 0 のコレクションが返されます。 呼び出し元のピアがこのエンドポイントにサブスクライブされている場合、キャッシュは自動的に更新されます。それ以外の場合 RefreshData このメソッドを呼び出す前に呼び出す必要があります。
呼び出し元は、このメソッドが正常に完了するためにコラボレーション インフラストラクチャにサインインする必要はありません。 呼び出し元がこのメソッドを呼び出す前にサインインしている間に、 RefreshData またはいずれかの Subscribe メソッドの呼び出しが正常に完了している必要があります。
注: 追加のオーバーロードは、サブクラスのPeerとPeerContactの代わりに、PeerNearMe クラスで定義されます。
こちらもご覧ください
適用対象
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.PeerObjectCollectionPublic Function GetObjects (objectId As Guid) As PeerObjectCollectionパラメーター
返品
Peer 指定された Guidに関連付けられているオブジェクト。 オブジェクトが見つからない場合は、サイズ 0 のコレクションが返されます。
- 属性
例外
オブジェクト ID が null。
呼び出し元が PeerEndPoint にサブスクライブされていないか、 RefreshData() を呼び出していません。
ピアからオブジェクト情報を取得するときにエラーが発生しました。
注釈
この機能は、 PeerContact クラスでのみ公開されます。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。
ピア オブジェクトのコレクションは、このインスタンスで指定されたピアまたはエンドポイントのアプリケーション、データ オブジェクト、およびプレゼンス情報で構成されます。 エンドポイントのオブジェクトが見つからない場合は、サイズ 0 のコレクションが返されます。 呼び出し元ピアがこのエンドポイントにサブスクライブされると、キャッシュは自動的に更新されます。それ以外の場合 RefreshData このメソッドを呼び出す前に呼び出す必要があります。
呼び出し元は、このメソッドが正常に完了するためにコラボレーション インフラストラクチャにサインインする必要はありません。 呼び出し元がこのメソッドを呼び出す前にサインインしている間に、 RefreshData またはいずれかの Subscribe メソッドの呼び出しが正常に完了している必要があります。 このメソッドを呼び出す場合は、PermissionStateのUnrestrictedが必要です。 この状態は、コラボレーション セッションの開始時に作成されます。
注: 派生クラスのPeerとPeerContactの代わりに、PeerNearMe クラスに追加のオーバーロードが定義されます。
