Поделиться через


Peer.GetObjects Метод

Определение

Возвращает из локального кэша коллекцию объектов данных, зарегистрированных одноранговым узелом.

Перегрузки

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.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

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

Коллекция объектов PeerObject для однорангового узла или конечной точки, заданной этим экземпляром.

Атрибуты

Исключения

Вызывающий узел не подписан на конечную точку или еще не выполнял вызов метода RefreshData().

Не удается завершить работу метода из-за ошибки в инфраструктуре совместной работы в одноранговой сети.

Комментарии

Эта функция предоставляется только в PeerContact классе . Эта функция не предоставляется ни одному другому типу одноранговых узлов по соображениям безопасности.

Если в одноранговом сеансе совместной работы не был создан экземпляр с PermissionStateUnrestricted, этот метод не может получить доступ к объектам на локальном компьютере. То же самое относится и к приложениям, зарегистрированным в сеансе совместной работы.

Коллекция одноранговых объектов состоит из приложения, объекта данных и сведений о присутствии для однорангового узла или конечной точки, указанных этим экземпляром. Если объекты для конечной точки не найдены, возвращается коллекция нулевого размера (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.PeerObjectCollection
Public Function GetObjects (objectId As Guid) As PeerObjectCollection

Параметры

objectId
Guid

Объект Guid объекта, Peer извлекаемого из коллекции.

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

Объект Peer, связанный с заданным идентификатором Guid. Если объект не найден, возвращается коллекция размера нуль (0) записей.

Атрибуты

Исключения

Идентификатор объекта равен пустой ссылке (null).

Вызывающий узел не подписан на объект PeerEndPoint или еще не вызывал для конечной точки метод RefreshData().

Произошла ошибка при получении от однорангового узла сведений об объекте.

Комментарии

Эта функция предоставляется только в PeerContact классе . Эта функция не предоставляется ни одному другому типу одноранговых узлов по соображениям безопасности.

Коллекция одноранговых объектов состоит из приложения, объекта данных и сведений о присутствии для однорангового узла или конечной точки, указанных этим экземпляром. Если объекты для конечной точки не найдены, возвращается коллекция нулевого размера (0). Когда вызывающий одноранговый узел подписан на эту конечную точку, кэш обновляется автоматически; в противном случае RefreshData должен вызываться перед вызовом этого метода.

Для успешного выполнения этого метода не требуется вход вызывающего объекта в инфраструктуру совместной работы. Успешный вызов RefreshData или один из Subscribe методов должен быть завершен, пока вызывающий объект выполнял вход до вызова этого метода. Для вызова этого метода требуется .PermissionStateUnrestricted Это состояние создается при запуске сеанса совместной работы.

ПРИМЕЧАНИЕ. Дополнительные перегрузки определяются в Peer классе вместо производных классов PeerContact и PeerNearMe.

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

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