PeerCollaboration.GetPeersNearMe Metoda

Definice

Obor názvů:

System.Net.PeerToPeer.Collaboration

Sestavení:

System.Net.dll

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

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

PeerNearMeCollection

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 velikosti nula (0).

Atributy

SecurityCriticalAttribute

Výjimky

InvalidOperationException

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

PeerToPeerException

Při pokusu této metody o výčet všech známých Lidé blízkých koncových bodů byla vrácena 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ě vyplně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.