Freigeben über


PeerCollaboration.GetPeersNearMe Methode

Definition

Gibt eine Auflistung aller PeerCollaboration-Endpunkte zurück, die gegenwärtig am Netzwerkteilnetz des aufrufenden Peers angemeldet sind.

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

Gibt zurück

Eine PeerNearMeCollection mit allen PeerCollaboration-Endpunkten, die gegenwärtig im Bereich "Personen in meiner Umgebung" angemeldet sind.

Wenn keine Peers im Teilnetz gefunden werden, wird eine Auflistung der Größe 0 (null) zurückgegeben.

Attribute

Ausnahmen

Der Peer ist nicht im Bereich "Personen in meiner Umgebung" angemeldet.

Beim Versuch dieser Methode, alle bekannten Endpunkte in Personen in meiner Umgebung aufzulisten, wurde ein ungültiger Wert zurückgegeben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie PeersNearMe als PeerNearMeCollection abgerufen wird:

//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;
}

Hinweise

Die Rückgabe einer vollständig ausgefüllten PeerNearMeCollection über diese Methode kann abhängig von der Netzwerktopologie und Latenz eine unbestimmte Zeit nach der Anmeldung erfordern.

Für den Aufruf dieser Methode ist eine PermissionState von Unrestrictederforderlich. Dieser Zustand wird erstellt, wenn die Peer Zusammenarbeitssitzung beginnt.

Gilt für: