PeerNameResolver.ResolveAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
これらのメソッドは、呼び出し元のピアに認識されているすべてのクラウド内で、指定した PeerName の非同期解決操作を開始します。
オーバーロード
ResolveAsync(PeerName, Object) |
呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。 |
ResolveAsync(PeerName, Int32, Object) |
|
ResolveAsync(PeerName, Cloud, Object) | |
ResolveAsync(PeerName, Cloud, Int32, Object) |
指定された Cloud で、指定された PeerName の非同期のピア名解決操作を開始します。 この解決操作では、指定したピア名に対し |
注釈
すべての Resolve メソッドに対して、非同期処理が必要な場合に使用される同等 ResolveAsync のメソッドがあります。 ResolveAsync にイベント処理用のシステム トークンがパラメーター リストに含まれていることを除き、渡されるパラメーターでは同じです。
Resolve メソッドと ResolveAsync メソッドの間でパラメーターの不一致が発生し Cloud 、パラメーターが指定されていない場合、メソッドはショートカットを Available 使用してクラウド パラメーターを入力します。
ResolveAsync(PeerName, Object)
呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。
public:
void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Object ^ userState);
public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, object userState);
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * obj -> unit
Public Sub ResolveAsync (peerName As PeerName, userState As Object)
パラメーター
- userState
- Object
ピア名解決操作に関する状態情報を格納するユーザー定義のオブジェクト。
例外
peerName
と userState
のパラメーターの一方または両方が null
に設定されます。
注釈
このメソッドは、ピア名をクラウドに非同期的に関連付けます。 すべてのクラウドに 対して クエリが実行 PeerNameされます。 イベントが発生し ResolveCompleted 、 メソッドが呼び出されます OnResolveCompleted 。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。
ピア名を解決できない場合は、 PeerToPeerException がスローされます。
セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。
メソッドの PeerNameResolver 呼び出しは、 内の ResolveAsync ピア名レコードごとに メソッドを呼び出すのと PeerNameRecordCollection似ています。 個々のピア名レコードで Resolve メソッドを使用しても、複数のピア名の解決は無効にならないことに注意してください。
すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。
リゾルバー オブジェクトへの非同期参照はすべて、一意の識別子トークンと調整されます。 この userState
トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。
解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。
適用対象
ResolveAsync(PeerName, Int32, Object)
maxRecords
未満のピア名エントリを返して、呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。
public:
void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, int maxRecords, System::Object ^ userState);
public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, int maxRecords, object userState);
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * int * obj -> unit
Public Sub ResolveAsync (peerName As PeerName, maxRecords As Integer, userState As Object)
パラメーター
- maxRecords
- Int32
取得するピア名のレコードの最大数。
- userState
- Object
解決操作に関する情報を格納するユーザー定義のオブジェクト。
例外
peerName
と userState
のパラメーターの一方または両方が null
に設定されます。
maxRecords
パラメーターが 0 以下です。
注釈
このメソッドは、ピア名をクラウドに非同期的に関連付けます。 すべてのクラウドに 対して クエリが実行 PeerNameされます。 セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。 ピア名を解決できない場合、または が である場合は null
、 PeerToPeerException がスローされます。
このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。
すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。
リゾルバー オブジェクトへの非同期参照はすべて、一意識別子トークン Objectと連携します。 この userState
トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。
解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。
適用対象
ResolveAsync(PeerName, Cloud, Object)
public:
void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud, System::Object ^ userState);
public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud, object userState);
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * obj -> unit
Public Sub ResolveAsync (peerName As PeerName, cloud As Cloud, userState As Object)
パラメーター
例外
peerName
と userState
のパラメーターの一方または両方が null
に設定されます。
注釈
このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。
セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。
パラメーターが のCloud場合、名前はショートカットをAvailable使用して解決されます。これにより、、Scope、および ScopeId プロパティの既定値がName初期化null
されます。
すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。
リゾルバー オブジェクトへの非同期参照はすべて、一意の識別子トークンと調整されます。 この userState
トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。
解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。
適用対象
ResolveAsync(PeerName, Cloud, Int32, Object)
public:
void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud, int maxRecords, System::Object ^ userState);
[System.Security.SecurityCritical]
public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud, int maxRecords, object userState);
[<System.Security.SecurityCritical>]
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * int * obj -> unit
Public Sub ResolveAsync (peerName As PeerName, cloud As Cloud, maxRecords As Integer, userState As Object)
パラメーター
- peerName
- PeerName
解決する peerName
。
- cloud
- Cloud
peerName
を解決する対象の cloud
。
- maxRecords
- Int32
peerName
に対して cloud
から取得するレコードの最大数。
- userState
- Object
ピア名解決操作に関する情報を格納するユーザー定義のオブジェクト。
- 属性
例外
peerName
と userState
のパラメーターの一方または両方が null
に設定されます。
指定された 1 つ以上のパラメーターが無効です。
この操作を正常に完了するには、少なくとも 1 つのイベント ハンドラーが必要です。
maxRecords
パラメーターが 0 以下です。
注釈
セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。
このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。
パラメーターが のCloud場合、名前はショートカットをAvailable使用して解決されます。これにより、、Scope、および ScopeId プロパティの既定値がName初期化null
されます。
すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。
ピア リゾルバー オブジェクトへのすべての非同期参照は、一意の識別子トークン Objectと調整されます。 この userState
トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。
解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。
適用対象
.NET