PeerCollaboration.GetPeersNearMe Método

Definición

Espacio de nombres:
System.Net.PeerToPeer.Collaboration
Ensamblado:
System.Net.dll

Devuelve una colección de todos los PeerCollaboration puntos de conexión que han iniciado sesión actualmente en la subred de red del mismo nivel que realiza 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

que PeerNearMeCollection contiene todos los PeerCollaboration puntos de conexión que han iniciado sesión actualmente en el ámbito "Near Me".

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 "Near Me".

PeerToPeerException

Se devolvió un valor no válido cuando este método intentó enumerar todos los puntos de conexión conocidos de People Near Me.

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 completamente rellenado a través de este método puede requerir una cantidad indeterminada PeerNearMeCollection de tiempo 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.

Se aplica a