Peer.GetObjects 메서드

정의

로컬 캐시에서 피어가 등록한 데이터 개체의 컬렉션을 가져옵니다.Gets the collection of data objects that were registered by the peer from a local cache.

오버로드

GetObjects()

로컬 캐시에서 데이터 개체의 컬렉션을 가져옵니다.Gets the collection of data objects from a local cache.

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()

로컬 캐시에서 데이터 개체의 컬렉션을 가져옵니다.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 는 서브 클래스 PeerContactPeerNearMe입니다.NOTE: Additional overloads are defined on the Peer class instead of the subclasses PeerContact and PeerNearMe.

추가 정보

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 개체의 Peer입니다.The 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 파생된 클래스가 아닌 클래스 PeerContactPeerNearMe입니다.NOTE: Additional overloads are defined on the Peer class instead of the derived classes PeerContact and PeerNearMe.

추가 정보

적용 대상