Peer.GetObjects Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Auflistung von Datenobjekten ab, die vom Peer aus einem lokalen Cache registriert wurden.
Überlädt
| GetObjects() |
Ruft die Auflistung von Datenobjekten aus einem lokalen Cache ab. |
| GetObjects(Guid) |
Ruft das Peer-Objekt ab, das der aus der Guid bereitgestellten PeerObjectCollection zugeordnet ist. |
Hinweise
Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.
Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben.
GetObjects()
Ruft die Auflistung von Datenobjekten aus einem lokalen Cache ab.
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.PeerObjectCollectionPublic Function GetObjects () As PeerObjectCollectionGibt zurück
Die PeerObject-Auflistung für den von dieser Instanz angegebenen Peer oder Endpunkt.
- Attribute
Ausnahmen
Der Aufrufer ist nicht für den Endpunkt abonniert oder hat noch nicht RefreshData() aufgerufen.
Die Methode kann aufgrund eines Fehlers in der zugrunde liegenden Peerzusammenarbeitsinfrastruktur nicht abgeschlossen werden.
Hinweise
Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.
Wenn die Peerzusammenarbeitssitzung nicht mit einem PermissionState instanziieren wurde Unrestricted, kann diese Methode nicht auf Objekte auf dem lokalen Computer zugreifen. Das gleiche gilt für die Anwendungen, die in der Zusammenarbeitssitzung registriert wurden.
Die Sammlung von Peerobjekten besteht aus Anwendungs-, Datenobjekt- und Anwesenheitsinformationen für den Peer oder Endpunkt, der von diesem instance angegeben wird. Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben. Wenn der aufrufende Peer diesen Endpunkt abonniert hat, wird der Cache automatisch aktualisiert. andernfalls RefreshData muss vor dem Aufrufen dieser Methode aufgerufen werden.
Der Aufrufer muss nicht bei der Zusammenarbeitsinfrastruktur angemeldet werden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein erfolgreicher Aufruf RefreshData von oder einer der Subscribe Methoden muss abgeschlossen sein, während der Aufrufer zuvor angemeldet wurde, um diese Methode aufzurufen.
HINWEIS: Zusätzliche Überladungen werden für die Peer -Klasse anstelle der Unterklassen PeerContact und PeerNearMedefiniert.
Weitere Informationen
Gilt für:
GetObjects(Guid)
Ruft das Peer-Objekt ab, das der aus der Guid bereitgestellten PeerObjectCollection zugeordnet ist.
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.PeerObjectCollectionPublic Function GetObjects (objectId As Guid) As PeerObjectCollectionParameter
Gibt zurück
Das Peer-Objekt, das der bereitgestellten Guid zugeordnet ist. Wenn ein Objekt nicht gefunden wurde, wird eine Auflistung der Größe 0 (null) zurückgegeben.
- Attribute
Ausnahmen
Die Objekt-ID ist null.
Der Aufrufer ist nicht für den PeerEndPoint abonniert oder hat noch nicht RefreshData() für den Endpunkt aufgerufen.
Fehler beim Abrufen von Objektinformationen aus dem Peer.
Hinweise
Diese Funktionalität wird nur für die PeerContact -Klasse verfügbar gemacht. Diese Funktionalität wird aus Sicherheitsgründen auf keinem anderen Peertyp verfügbar gemacht.
Die Sammlung von Peerobjekten besteht aus Anwendungs-, Datenobjekt- und Anwesenheitsinformationen für den Peer oder Endpunkt, der von diesem instance angegeben wird. Wenn keine Objekte für den Endpunkt gefunden werden, wird eine Auflistung der Größe 0 (0) zurückgegeben. Wenn der aufrufende Peer diesen Endpunkt abonniert hat, wird der Cache automatisch aktualisiert. andernfalls RefreshData muss vor dem Aufrufen dieser Methode aufgerufen werden.
Der Aufrufer muss nicht bei der Zusammenarbeitsinfrastruktur angemeldet werden, damit diese Methode erfolgreich abgeschlossen werden kann. Ein erfolgreicher Aufruf RefreshData von oder einer der Subscribe Methoden muss abgeschlossen sein, während der Aufrufer zuvor angemeldet wurde, um diese Methode aufzurufen. Für das Aufrufen dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Zusammenarbeitssitzung beginnt.
HINWEIS: Zusätzliche Überladungen werden für die Peer -Klasse anstelle der abgeleiteten Klassen PeerContact und PeerNearMedefiniert.
