PeerCollaboration.GetPeersNearMe メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
呼び出し元のピアのネットワーク サブネットに現在サインインしている、すべての 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 エンドポイントを格納している PeerCollaboration。
ピアがサブネットで検出されない場合、サイズがゼロ (0) のコレクションが返されます。
- 属性
ピアが "近くの人" スコープにサインインしていません。
このメソッドが、既知のすべての "近くの人との接続" エンドポイントを列挙しようとしたときに、無効な値が返されました。
次のコード例は、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 を返すには、ネットワーク トポロジと待機時間に応じて、サインイン後に不確定な時間が必要になる場合があります。
このメソッドを呼び出す場合は、 の UnrestrictedがPermissionState必要です。 この状態は、コラボレーション セッションの開始時に Peer 作成されます。
製品 | バージョン |
---|---|
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。