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 ();
[<System.Security.SecurityCritical>]
member this.GetObjects : unit -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

Возвращаемое значение

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.

Если в сеансе совместной работы однорангового узла не был создан экземпляр с PermissionState Unrestricted , этот метод не может получить доступ к объектам на локальном компьютере.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)

Возвращает объект 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);
[<System.Security.SecurityCritical>]
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

Возвращаемое значение

PeerObjectCollection

Объект Peer, связанный с заданным идентификатором Guid.Peer object associated with the supplied Guid. Если объект не найден, возвращается коллекция размера нуль (0) записей.If an object is not found, a collection of size zero (0) is returned.

Атрибуты

Исключения

Идентификатор объекта равен пустой ссылке (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. Для вызова этого метода требуется PermissionState объект Unrestricted .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.

См. также раздел

Применяется к