Peer.GetObjects Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera kolekcję obiektów danych zarejestrowanych przez element równorzędny z lokalnej pamięci podręcznej.
Przeciążenia
| Nazwa | Opis |
|---|---|
| GetObjects() |
Pobiera kolekcję obiektów danych z lokalnej pamięci podręcznej. |
| GetObjects(Guid) |
Peer Pobiera obiekt skojarzony z elementem dostarczonym Guid z obiektu PeerObjectCollection. |
Uwagi
Ta funkcja jest dostępna tylko w PeerContact klasie . Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.
Jeśli dla punktu końcowego nie znaleziono żadnych obiektów, zwracana jest kolekcja o rozmiarze zero (0).
GetObjects()
Pobiera kolekcję obiektów danych z lokalnej pamięci podręcznej.
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
Zwraca
Kolekcja PeerObject elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie.
- Atrybuty
Wyjątki
Obiekt wywołujący nie jest subskrybowany do punktu końcowego lub nie został jeszcze wywołany .RefreshData()
Metoda nie może zostać ukończona z powodu błędu w podstawowej infrastrukturze współpracy równorzędnej.
Uwagi
Ta funkcja jest dostępna tylko w PeerContact klasie . Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.
Jeśli sesja współpracy równorzędnej nie tworzyła wystąpienia za pomocą PermissionStateUnrestrictedklasy , ta metoda nie może uzyskać dostępu do obiektów na komputerze lokalnym. To samo dotyczy aplikacji zarejestrowanych w sesji współpracy.
Kolekcja obiektów równorzędnych składa się z aplikacji, obiektu danych i informacji o obecności elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie. Jeśli dla punktu końcowego nie znaleziono żadnych obiektów, zwracana jest kolekcja o rozmiarze zero (0). Jeśli element równorzędny wywołujący jest subskrybowany do tego punktu końcowego, pamięć podręczna zostanie automatycznie zaktualizowana; w przeciwnym razie RefreshData należy wywołać metodę przed wywołaniem tej metody.
Obiekt wywołujący nie musi być zalogowany do infrastruktury współpracy, aby ta metoda została pomyślnie ukończona. Pomyślne wywołanie metody RefreshData lub jedna z Subscribe metod musi zostać ukończona, gdy obiekt wywołujący został podpisany wcześniej w celu wywołania tej metody.
UWAGA: Dodatkowe przeciążenia są definiowane w Peer klasie zamiast podklas PeerContact i PeerNearMe.
Zobacz też
Dotyczy
GetObjects(Guid)
Peer Pobiera obiekt skojarzony z elementem dostarczonym Guid z obiektu 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
Parametry
Zwraca
Peer obiekt skojarzony z podanym Guidelementem . Jeśli obiekt nie zostanie znaleziony, zostanie zwrócona kolekcja o rozmiarze zero (0).
- Atrybuty
Wyjątki
Identyfikator obiektu to null.
Obiekt wywołujący nie jest subskrybowany do elementu PeerEndPoint lub jeszcze go nie wywołał RefreshData() .
Wystąpił błąd podczas pobierania informacji o obiekcie z elementu równorzędnego.
Uwagi
Ta funkcja jest dostępna tylko w PeerContact klasie . Ta funkcja nie jest widoczna dla żadnego innego typu elementu równorzędnego ze względów bezpieczeństwa.
Kolekcja obiektów równorzędnych składa się z aplikacji, obiektu danych i informacji o obecności elementu równorzędnego lub punktu końcowego określonego przez to wystąpienie. Jeśli dla punktu końcowego nie znaleziono żadnych obiektów, zwracana jest kolekcja o rozmiarze zero (0). Gdy element równorzędny wywołujący jest subskrybowany do tego punktu końcowego, pamięć podręczna jest automatycznie aktualizowana; w przeciwnym razie RefreshData należy wywołać metodę przed wywołaniem tej metody.
Obiekt wywołujący nie musi być zalogowany do infrastruktury współpracy, aby ta metoda została pomyślnie ukończona. Pomyślne wywołanie metody RefreshData lub jedna z Subscribe metod musi zostać ukończona, gdy obiekt wywołujący został podpisany wcześniej w celu wywołania tej metody. Wywołanie tej metody wymaga wartości PermissionStateUnrestricted. Ten stan jest tworzony po rozpoczęciu sesji współpracy.
UWAGA: Dodatkowe przeciążenia są definiowane w Peer klasie zamiast klas PeerContact pochodnych i PeerNearMe.