PeerCollaboration.GetPeersNearMe 메서드

정의

네임스페이스:

System.Net.PeerToPeer.Collaboration

어셈블리:

System.Net.dll

호출 피어의 네트워크 서브넷에 현재 로그인한 모든 PeerCollaboration 엔드포인트의 컬렉션을 반환합니다.

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

반환

PeerNearMeCollection

'주변 사람 찾기' 범위에 현재 로그인한 모든 PeerNearMeCollection 엔드포인트를 포함하는 PeerCollaboration입니다.

서브넷에 로그인한 피어가 없으면 크기가 0인 컬렉션이 반환됩니다.

특성

SecurityCriticalAttribute

예외

InvalidOperationException

피어가 '주변 사람 찾기' 범위에 로그인하지 않은 경우

PeerToPeerException

이 메서드에서 알려진 모든 주변 사람 찾기 엔드포인트를 열거하려고 할 때 잘못된 값이 반환된 경우

예제

다음 코드 예제는 PeerNearMeCollection으로 PeersNearMe를 검색 하는 방법을 보여 줍니다.

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

설명

완전히 채워진 반환 PeerNearMeCollection 이 메서드를 통해 비활성화 된 네트워크 토폴로지 및 대기 시간에 따라 로그인 한 후 시간 필요할 수 있습니다.

이 메서드를 호출 하려면를 PermissionState 의 Unrestricted합니다. 이 상태는 때 생성 되는 Peer 협업 세션을 시작 합니다.