PeerCollaboration.GetPeersNearMe Método

Definición

Espacio de nombres:

System.Net.PeerToPeer.Collaboration

Ensamblado:

System.Net.dll

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.

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'.

Si no se detectan elementos del mismo nivel en la subred, se devuelve una colección de tamaño cero (0).

Atributos

SecurityCriticalAttribute

Excepciones

InvalidOperationException

El elemento del mismo nivel no ha iniciado sesión en el ámbito 'Equipos próximos'.

PeerToPeerException

Se devolvió un valor no válido cuando este método intentó enumerar todos los extremos Equipos a mi alrededor conocidos.

Ejemplos

En el ejemplo de código siguiente se muestra cómo recuperar PeersNearMe como 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 elemento rellenado completamente a través de este método puede requerir una cantidad de tiempo indeterminada PeerNearMeCollection después del inicio de sesión en función de la topología de red y la latencia.

Llamar a este método requiere un PermissionState de Unrestricted. Este estado se crea cuando comienza la Peer sesión de colaboración.