PeerNameResolver.ResolveAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Эти методы начинают асинхронную операцию разрешения указанного имени PeerName во всех облаках, известных вызывающему узлу.
Перегрузки
ResolveAsync(PeerName, Object) |
Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу. |
ResolveAsync(PeerName, Int32, Object) |
Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу, возвращая не более |
ResolveAsync(PeerName, Cloud, Object) |
Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud. |
ResolveAsync(PeerName, Cloud, Int32, Object) |
Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud. Для указанного имени однорангового узла соответствующая операция разрешит не более такого количества записей: |
Комментарии
Для каждого 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
маркер или идентификатор сообщения позволяет операционной системе доставлять сообщение в один процесс получения после того, как сообщение будет помещено в очередь сообщений.
Событие ResolveCompleted будет возникать, если операция разрешения завершится с ошибкой или будет отменена.
Применяется к
ResolveAsync(PeerName, Int32, Object)
Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу, возвращая не более maxRecords
записей для имен одноранговых узлов.
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
меньше или равно нулю.
Комментарии
Этот метод асинхронно связывает имя однорангового узла с облаками. Все облака запрашиваются для PeerName. Для незащищенных имен одноранговых узлов одно и то же имя может быть зарегистрировано (и связано с разными конечными точками) разными одноранговыми узлами в одном облаке. Если имя однорангового узла не может быть разрешено или имеет значение null
, PeerToPeerException создается исключение .
Этот метод вызывает ResolveCompleted событие , которое вызывает метод .OnResolveCompleted Или вызывает ResolveProgressChanged событие , которое вызывает метод OnResolveProgressChanged .
Для каждого ResolveAsync метода существует эквивалентный Resolve метод. Их списки параметров идентичны, за исключением того, что метод ResolveAsync включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.
Все асинхронные ссылки на объект сопоставителя координируются с помощью маркера уникального идентификатора Object. Этот userState
маркер или идентификатор сообщения позволяет операционной системе доставлять сообщение в один процесс получения после того, как сообщение будет помещено в очередь сообщений.
Событие 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)
Параметры
- userState
- Object
Определяемый пользователем объект Object, который содержит сведения об операции разрешения имени однорангового узла.
Исключения
Хотя бы одному параметру (peerName
или userState
) присвоено значение null
.
Комментарии
Этот метод вызывает ResolveCompleted событие , которое вызывает метод .OnResolveCompleted Или вызывает ResolveProgressChanged событие , которое вызывает метод OnResolveProgressChanged .
Для незащищенных имен одноранговых узлов одно и то же имя может быть зарегистрировано (и связано с разными конечными точками) разными одноранговыми узлами в одном облаке.
Cloud Если параметр имеет значение null
, имя разрешается с помощью Available ярлыка, который инициализирует значения по умолчанию для Nameсвойств , Scopeи ScopeId .
Для каждого ResolveAsync метода существует эквивалентный Resolve метод. Их списки параметров идентичны, за исключением того, что метод ResolveAsync включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.
Все асинхронные ссылки на объект сопоставителя координируются с помощью маркера уникального идентификатора. Этот userState
маркер или идентификатор сообщения позволяет операционной системе доставлять сообщение в один процесс получения после того, как сообщение будет помещено в очередь сообщений.
Событие 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
Объект cloud
, в котором необходимо разрешить peerName
.
- maxRecords
- Int32
Максимальное число записей для получения из параметра cloud
для peerName
.
- userState
- Object
Определяемый пользователем объект, содержащий сведения об операции разрешения имени однорангового узла.
- Атрибуты
Исключения
Хотя бы одному параметру (peerName
или userState
) присвоено значение null
.
Один или несколько указанных параметров недопустимы.
Чтобы успешно завершить эту операцию, требуется по крайней мере один обработчик событий.
Значение параметра maxRecords
меньше или равно нулю.
Комментарии
Для незащищенных имен одноранговых узлов одно и то же имя может быть зарегистрировано (и связано с разными конечными точками) разными одноранговыми узлами в одном облаке.
Этот метод вызывает ResolveCompleted событие , которое вызывает метод .OnResolveCompleted Или вызывает ResolveProgressChanged событие , которое вызывает метод OnResolveProgressChanged .
Cloud Если параметр имеет значение null
, имя разрешается с помощью Available ярлыка, который инициализирует значения по умолчанию для Nameсвойств , Scopeи ScopeId .
Для каждого ResolveAsync метода существует эквивалентный Resolve метод. Их списки параметров идентичны, за исключением того, что метод ResolveAsync включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.
Все асинхронные ссылки на объект однорангового сопоставителя координируются с помощью маркера уникального идентификатора Object. Этот userState
маркер или идентификатор сообщения позволяет операционной системе доставлять сообщение в один процесс получения после того, как сообщение будет помещено в очередь сообщений.
Событие ResolveCompleted будет возникать, если операция разрешения завершится с ошибкой или будет отменена.