Peer.GetObjects Peer.GetObjects Peer.GetObjects Peer.GetObjects Method

定義

ピアによって登録されたデータ オブジェクトのコレクションを、ローカル キャッシュから取得します。Gets the collection of data objects that were registered by the peer from a local cache.

オーバーロード

GetObjects() GetObjects() GetObjects() GetObjects()

データ オブジェクトのコレクションをローカル キャッシュから取得します。Gets the collection of data objects from a local cache.

GetObjects(Guid) GetObjects(Guid) GetObjects(Guid) GetObjects(Guid)

指定された Peer に関連付けられた Guid オブジェクトを PeerObjectCollection から取得します。Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

注釈

この機能はPeerContactクラスでのみ公開されます。This functionality is only exposed on the PeerContact class. この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。This functionality is not exposed on any other type of peer for security reasons.

エンドポイントのオブジェクトが見つからない場合は、サイズがゼロ (0) のコレクションが返されます。If no objects are found for the endpoint, a collection of size zero (0) is returned.

GetObjects() GetObjects() GetObjects() GetObjects()

データ オブジェクトのコレクションをローカル キャッシュから取得します。Gets the collection of data objects from a local cache.

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects();
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects ();
member this.GetObjects : unit -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

戻り値

このインスタンスによって指定されたピアまたはエンドポイントの PeerObject のコレクション。The PeerObject collection for the peer or endpoint specified by this instance.

例外

呼び出し元がエンドポイントをサブスクライブしていないか、RefreshData() をまだ呼び出していません。The caller is not subscribed to the endpoint or has not yet called RefreshData().

基になるピア コラボレーション インフラストラクチャのエラーが原因で、メソッドを完了できません。The method is unable to complete due to an error in the underlying Peer Collaboration infrastructure.

注釈

この機能はPeerContactクラスでのみ公開されます。This functionality is only exposed on the PeerContact class. この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。This functionality is not exposed on any other type of peer for security reasons.

ピアコラボレーションセッションがPermissionStateUnrestrictedでインスタンス化されなかった場合、このメソッドはローカルコンピューター上のオブジェクトにアクセスできません。If the peer collaboration session did not instantiate with a PermissionState of Unrestricted, this method cannot access objects on the local computer. これは、コラボレーションセッションに登録されているアプリケーションにも当てはまります。The same is true of the applications registered into the collaboration session.

ピアオブジェクトのコレクションは、このインスタンスによって指定されたピアまたはエンドポイントのアプリケーション、データオブジェクト、およびプレゼンス情報で構成されます。The collection of peer objects consists of application, data object, and presence information for the peer or endpoint specified by this instance. エンドポイントのオブジェクトが見つからない場合は、サイズがゼロ (0) のコレクションが返されます。If no objects are found for the endpoint, a collection of size zero (0) is returned. 呼び出し元のピアがこのエンドポイントをサブスクライブしている場合、キャッシュは自動的に更新されます。それRefreshData以外の場合は、このメソッドを呼び出す前にを呼び出す必要があります。If the calling peer is subscribed to this endpoint, the cache is automatically updated; otherwise RefreshData must be called prior to calling this method.

このメソッドを正常に完了するには、呼び出し元がコラボレーションインフラストラクチャにサインインする必要はありません。The caller is not required to be signed into the collaboration infrastructure for this method to complete successfully. RefreshDataまたはSubscribeのいずれかのメソッドの呼び出しが完了している必要があります。呼び出し元がこのメソッドを呼び出すために以前にサインインしています。A successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was signed in previous to calling this method.

注: 追加のオーバーロードは、サブPeer PeerContactクラスおよびPeerNearMeではなく、クラスで定義されます。NOTE: Additional overloads are defined on the Peer class instead of the subclasses PeerContact and PeerNearMe.

こちらもご覧ください

GetObjects(Guid) GetObjects(Guid) GetObjects(Guid) GetObjects(Guid)

指定された Peer に関連付けられた Guid オブジェクトを PeerObjectCollection から取得します。Gets the Peer object associated with the supplied Guid from the PeerObjectCollection.

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(Guid objectId);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (Guid objectId);
member this.GetObjects : Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (objectId As Guid) As PeerObjectCollection

パラメーター

objectId
Guid Guid Guid Guid

コレクションから取得する Guid オブジェクトの PeerThe Guid of the Peer object to be retrieved from the collection

戻り値

指定された Peer に関連付けられた Guid オブジェクト。Peer object associated with the supplied Guid. オブジェクトが見つからない場合、サイズがゼロ (0) のコレクションが返されます。If an object is not found, a collection of size zero (0) is returned.

例外

オブジェクトの ID が null です。The object ID is null.

呼び出し元が PeerEndPoint をサブスクライブしていないか、RefreshData() をまだ呼び出していません。The caller is not subscribed to the PeerEndPoint or has not yet called RefreshData() against it.

ピアからオブジェクト情報を取得するときにエラーが発生しました。An error occurred when getting object information from the peer.

注釈

この機能はPeerContactクラスでのみ公開されます。This functionality is only exposed on the PeerContact class. この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。This functionality is not exposed on any other type of peer for security reasons.

ピアオブジェクトのコレクションは、このインスタンスによって指定されたピアまたはエンドポイントのアプリケーション、データオブジェクト、およびプレゼンス情報で構成されます。The collection of peer objects consists of application, data object, and presence information for the peer or endpoint specified by this instance. エンドポイントのオブジェクトが見つからない場合は、サイズがゼロ (0) のコレクションが返されます。If no objects are found for the endpoint, a collection of size zero (0) is returned. 呼び出し元のピアがこのエンドポイントにサブスクライブされると、キャッシュが自動的に更新されます。それRefreshData以外の場合は、このメソッドを呼び出す前にを呼び出す必要があります。When the calling peer is subscribed to this endpoint, the cache is automatically updated; otherwise RefreshData must be called prior to calling this method.

このメソッドを正常に完了するには、呼び出し元がコラボレーションインフラストラクチャにサインインする必要はありません。The caller is not required to be signed into the collaboration infrastructure for this method to complete successfully. RefreshDataまたはSubscribeのいずれかのメソッドの呼び出しが完了している必要があります。呼び出し元がこのメソッドを呼び出すために以前にサインインしています。A successful call to RefreshData or one of the Subscribe methods must have been completed while the caller was signed in previous to calling this method. このメソッドを呼び出すにPermissionStateUnrestricted、のが必要です。Calling this method requires a PermissionState of Unrestricted. この状態は、コラボレーションセッションの開始時に作成されます。This state is created when the collaboration session begins.

注: その他のオーバーロードは、 Peer派生クラスPeerContactおよびPeerNearMeではなく、クラスで定義されます。NOTE: Additional overloads are defined on the Peer class instead of the derived classes PeerContact and PeerNearMe.

こちらもご覧ください

適用対象