PeerCollaboration.GetPeersNearMe Method

Definition

Restituisce l'insieme di tutti gli endpoint PeerCollaboration attualmente connessi alla rete subnet del peer chiamante.Returns a collection of all the PeerCollaboration endpoints currently signed in on the network subnet of the calling peer.

public:
 static System::Net::PeerToPeer::Collaboration::PeerNearMeCollection ^ GetPeersNearMe();
[System.Security.SecurityCritical]
public static System.Net.PeerToPeer.Collaboration.PeerNearMeCollection GetPeersNearMe ();
static member GetPeersNearMe : unit -> System.Net.PeerToPeer.Collaboration.PeerNearMeCollection
Public Shared Function GetPeersNearMe () As PeerNearMeCollection

Returns

PeerNearMeCollection

Oggetto PeerNearMeCollection contenente tutti gli endpoint PeerCollaboration attualmente connessi all'ambito "Persone nelle vicinanze".A PeerNearMeCollection that contains all the PeerCollaboration endpoints currently signed into the 'Near Me' scope.

Se nella subnet non viene rilevato alcun peer, viene restituito un insieme avente dimensioni nulle.If peers are not discovered on the subnet, a collection of size zero (0) is returned.

Attributes

Exceptions

Il peer non è connesso all'ambito "Persone nelle vicinanze".The peer is not signed in to the 'Near Me' scope.

Il tentativo di enumerazione di tutti gli endpoint Persone nelle vicinanze noti ha comportato la restituzione di un valore non valido.An invalid value was returned when this method attempted to enumerate all known People Near Me endpoints.

Examples

Nell'esempio di codice seguente viene illustrato come recuperare PeersNearMe come PeerNearMeCollection:The following code example illustrates how to retrieve PeersNearMe as a 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;
}

Remarks

La restituzione di un PeerNearMeCollection completamente popolato tramite questo metodo può richiedere un periodo di tempo indeterminato dopo l'accesso a seconda della topologia di rete e della latenza.The return of a fully populated PeerNearMeCollection via this method can require an indeterminate amount of time after sign-in depending on network topology and latency.

Per chiamare questo metodo è necessario un PermissionState di Unrestricted.Calling this method requires a PermissionState of Unrestricted. Questo stato viene creato all'inizio della sessione di collaborazione Peer.This state is created when the Peer collaboration session begins.

Applies to