PeerCollaboration.GetPeersNearMe Metoda

Definicja

Przestrzeń nazw:

System.Net.PeerToPeer.Collaboration

Zestaw:

System.Net.dll

Zwraca kolekcję wszystkich PeerCollaboration punktów końcowych aktualnie zalogowanych w podsieci sieciowej elementu równorzędnego wywołującego.

public:
 static System::Net::PeerToPeer::Collaboration::PeerNearMeCollection ^ GetPeersNearMe();

[System.Security.SecurityCritical]
public static System.Net.PeerToPeer.Collaboration.PeerNearMeCollection GetPeersNearMe ();

[<System.Security.SecurityCritical>]
static member GetPeersNearMe : unit -> System.Net.PeerToPeer.Collaboration.PeerNearMeCollection

Public Shared Function GetPeersNearMe () As PeerNearMeCollection

Zwraca

PeerNearMeCollection

Element PeerNearMeCollection zawierający wszystkie PeerCollaboration punkty końcowe aktualnie zalogowane do zakresu "Near Me".

Jeśli w podsieci nie odnaleziono elementów równorzędnych, zwracana jest kolekcja o zerowym rozmiarze (0).

Atrybuty

SecurityCriticalAttribute

Wyjątki

InvalidOperationException

Element równorzędny nie jest zalogowany do zakresu "Near Me".

PeerToPeerException

Zwrócono nieprawidłową wartość, gdy ta metoda próbowała wyliczyć wszystkie znane punkty końcowe Osoby Near Me.

Przykłady

Poniższy przykład kodu ilustruje sposób pobierania elementów równorzędnychNearMe jako elementu PeerNearMeCollection:

//This function retrieves the peers near me as a PeerNearMeCollection.
public static PeerNearMeCollection GetPeersNearMe()
{
    PeerNearMeCollection peers = null;
    try
    {
        peers = PeerCollaboration.GetPeersNearMe();
        if (peers == null ||
            peers.Count == 0)
        {
            Console.WriteLine("There are no peers near me.");
        }
        foreach (PeerNearMe pnm in peers)
        {
            Console.WriteLine("Getting the peers near me: {0}, nickname {1}, isOnline {2}",
                pnm.ToString(),
                pnm.Nickname,
                pnm.IsOnline);
        }
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("Could not obtain an enumeration of the peers near me: {0}", p2pEx.Message);
    }
    catch (InvalidOperationException ioEx)
    {
        Console.WriteLine("The application is no longer signed into the Peer Collaboration Infrastructure: {0}",
            ioEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unexpected exception caught when trying to enumerate the peers near me: {0}",
            ex.Message);
    }

    return peers;
}

Uwagi

Powrót w pełni wypełnionej PeerNearMeCollection za pośrednictwem tej metody może wymagać nieokreślonego czasu po zalogowaniu się w zależności od topologii sieci i opóźnienia.

Wywołanie tej metody wymaga wartości PermissionState .Unrestricted Ten stan jest tworzony po rozpoczęciu Peer sesji współpracy.