Sdílet prostřednictvím


PeerCollaboration.GetPeersNearMe Metoda

Definice

Vrátí kolekci všech PeerCollaboration koncových bodů aktuálně přihlášených v síťové podsíti volajícího partnera.

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

Návraty

A PeerNearMeCollection , který obsahuje všechny PeerCollaboration koncové body aktuálně přihlášené k oboru Near Me.

Pokud se v podsíti nezjistí partnerské vztahy, vrátí se kolekce s nulovou velikostí (0).

Atributy

Výjimky

Partnerský uzel není přihlášený k oboru Blízko mě.

Když se tato metoda pokusila vytvořit výčet všech známých koncových bodů Lidé Near Me, vrátila se neplatná hodnota.

Příklady

Následující příklad kódu ukazuje, jak načíst PeersNearMe jako 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;
}

Poznámky

Vrácení plně naplněného PeerNearMeCollection objektu pomocí této metody může vyžadovat neurčitou dobu po přihlášení v závislosti na topologii sítě a latenci.

Volání této metody vyžaduje .PermissionStateUnrestricted Tento stav se vytvoří při Peer zahájení relace spolupráce.

Platí pro