PeerCollaboration.GetPeersNearMe Método

Definición

Devuelve una colección de todos los extremos de PeerCollaboration que han iniciado sesión actualmente en la subred del elemento del mismo nivel de la llamada.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 ();
[<System.Security.SecurityCritical>]
static member GetPeersNearMe : unit -> System.Net.PeerToPeer.Collaboration.PeerNearMeCollection
Public Shared Function GetPeersNearMe () As PeerNearMeCollection

Devoluciones

PeerNearMeCollection

PeerNearMeCollection que contiene todos los extremos de PeerCollaboration que han iniciado sesión actualmente en el ámbito 'Equipos próximos'.A PeerNearMeCollection that contains all the PeerCollaboration endpoints currently signed into the 'Near Me' scope.

Si no se detectan elementos del mismo nivel en la subred, se devuelve una colección de tamaño cero (0).If peers are not discovered on the subnet, a collection of size zero (0) is returned.

Atributos

Excepciones

El elemento del mismo nivel no ha iniciado sesión en el ámbito 'Equipos próximos'.The peer is not signed in to the 'Near Me' scope.

Se devolvió un valor no válido cuando este método intentó enumerar todos los extremos Equipos a mi alrededor conocidos.An invalid value was returned when this method attempted to enumerate all known People Near Me endpoints.

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar PeersNearMe como 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;
}

Comentarios

La devolución de un rellenado completo PeerNearMeCollection mediante este método puede requerir una cantidad indeterminada de tiempo después del inicio de sesión en función de la topología y la latencia de red.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.

La llamada a este método requiere un PermissionState de Unrestricted .Calling this method requires a PermissionState of Unrestricted. Este estado se crea cuando se Peer inicia la sesión de colaboración.This state is created when the Peer collaboration session begins.

Se aplica a