次の方法で共有


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 は、このメソッドを呼び出す前に を呼び出す必要があります。

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

注: 追加のオーバーロードは、サブクラスPeerContactPeerNearMeではなく、 クラスで定義Peerされます。

こちらもご覧ください

適用対象

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

Guid Peerコレクションから取得するオブジェクトの 。

戻り値

指定された Peer に関連付けられた Guid オブジェクト。 オブジェクトが見つからない場合、サイズがゼロ (0) のコレクションが返されます。

属性

例外

オブジェクトの ID が null です。

呼び出し元が PeerEndPoint をサブスクライブしていないか、RefreshData() をまだ呼び出していません。

ピアからオブジェクト情報を取得するときにエラーが発生しました。

注釈

この機能は、 クラスでのみ公開されます PeerContact 。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。

ピア オブジェクトのコレクションは、このインスタンスで指定されたピアまたはエンドポイントのアプリケーション、データ オブジェクト、プレゼンス情報で構成されます。 エンドポイントのオブジェクトが見つからない場合は、サイズ 0 (0) のコレクションが返されます。 呼び出し元ピアがこのエンドポイントにサブスクライブされると、キャッシュは自動的に更新されます。それ以外の場合 RefreshData は、このメソッドを呼び出す前に を呼び出す必要があります。

このメソッドを正常に完了するために、呼び出し元がコラボレーション インフラストラクチャにサインインする必要はありません。 呼び出し元がこのメソッドを RefreshData 呼び出す前に Subscribe サインインしている間に、 または いずれかのメソッドの呼び出しが正常に完了している必要があります。 このメソッドを呼び出す場合は、 の UnrestrictedPermissionState必要です。 この状態は、コラボレーション セッションの開始時に作成されます。

注: 追加のオーバーロードは、派生クラスと PeerNearMeではなく、 クラスPeerContactで定義Peerされます。

こちらもご覧ください

適用対象