PeerNameResolver.ResolveAsync Метод

Определение

Эти методы начинают асинхронную операцию разрешения указанного имени PeerName во всех облаках, известных вызывающему узлу.These methods begin an asynchronous resolution operation for the specified PeerName in all clouds known to the calling peer.

Перегрузки

ResolveAsync(PeerName, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу.Begins an asynchronous peer name resolution operation for the specified PeerName in all clouds known to the calling peer.

ResolveAsync(PeerName, Int32, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу, возвращая не более maxRecords записей для имен одноранговых узлов.Begins an asynchronous peer name resolution operation for the specified PeerName in all clouds known to the calling peer, returning no more than maxRecords entries for the peer name.

ResolveAsync(PeerName, Cloud, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud.Begins an asynchronous peer name resolution operation for the specified PeerName in the specified Cloud.

ResolveAsync(PeerName, Cloud, Int32, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud.Begins an asynchronous peer name resolution operation for the specified PeerName in the specified Cloud. Для указанного имени однорангового узла соответствующая операция разрешит не более такого количества записей: maxRecords.The resolution operation will resolve no more than maxRecords entries for the specified peer name.

Комментарии

Для каждого Resolve метода существует эквивалентный ResolveAsync метод, который используется, когда требуется асинхронная обработка.For every Resolve method, there is an equivalent ResolveAsync method, which is used when asynchronous processing is required. Они идентичны в передаваемых параметрах, за исключением того, что Ресолвеасинк включает в свой список параметров системный токен для обработки событий.They are identical in the parameters they are passed, except that ResolveAsync includes a system token in its parameter list for event handling.

Если в методе Resolve и методе ресолвеасинк возникает несоответствие параметров, а Cloud параметр не указан, метод Available использует ярлык для заполнения параметров облака.If a parameter mismatch occurs between the Resolve method and the ResolveAsync method, and the Cloud parameter is not supplied, the method uses the Available shortcut to fill in cloud parameters.

ResolveAsync(PeerName, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу.Begins an asynchronous peer name resolution operation for the specified PeerName in all clouds known to the calling peer.

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

Параметры

peerName
PeerName

Имя PeerName для разрешения.The PeerName to resolve.

userState
Object

Определяемый пользователем объект, содержащий сведения о состоянии операции разрешения имени однорангового узла.A user-defined object that contains state information about the peer name resolution operation.

Исключения

Хотя бы одному параметру (peerName или userState) присвоено значение null.One or both of the peerName and userState parameters are set to null.

Комментарии

Этот метод асинхронно связывает имя однорангового узла с облаками.This method asynchronously associates a peer name to clouds. Все облака запрашиваются для PeerName.All clouds are queried for the PeerName. Он вызывает ResolveCompleted событие, которое вызывает OnResolveCompleted метод.It raises the ResolveCompleted event, which calls back to the OnResolveCompleted method. Или вызывает ResolveProgressChanged событие, которое вызывает OnResolveProgressChanged метод.Or, it raises the ResolveProgressChanged event, which calls back to the OnResolveProgressChanged method.

Если имя однорангового узла не может быть PeerToPeerException разрешено, создается исключение.If the peer name cannot be resolved, an PeerToPeerException is thrown.

Для незащищенных имен одноранговых узлов одно и то же имя можно зарегистрировать (и связать с разными конечными точками) разными одноранговыми узлами в одном облаке.For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud.

Вызов метода аналогичен ResolveAsync вызову метода для каждой записи имени PeerNameRecordCollectionоднорангового узла в. PeerNameResolverCalling the PeerNameResolver method is similar to calling the ResolveAsync method for each peer name record in the PeerNameRecordCollection. Обратите внимание, что использование метода Resolve для отдельной записи имени однорангового узла не делает недействительным разрешение нескольких одноранговых имен.Note that using the Resolve method on an individual peer name record does not invalidate resolving multiple peer names.

Для каждого ResolveAsync метода существует эквивалентный Resolve метод.For every ResolveAsync method, there is an equivalent Resolve method. Их списки параметров идентичны, за исключением того, что метод Ресолвеасинк включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing.

Все асинхронные ссылки на объект сопоставителя координируются с помощью уникального маркера идентификатора.All asynchronous references to the resolver object are coordinated with a unique identifier token. Этот userState маркер или идентификатор сообщения позволяет операционной системе доставлять сообщения одному процессу приема после помещения сообщения в очередь сообщений.This userState token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue.

ResolveCompleted Событие будет вызвано, если операция разрешения завершилась с ошибкой или отменена.The ResolveCompleted event will be raised if the resolve operation completes in error or is canceled.

ResolveAsync(PeerName, Int32, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для указанного значения PeerName во всех облаках, известных вызывающему одноранговому узлу, возвращая не более maxRecords записей для имен одноранговых узлов.Begins an asynchronous peer name resolution operation for the specified PeerName in all clouds known to the calling peer, returning no more than maxRecords entries for the peer name.

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

Параметры

peerName
PeerName

Имя PeerName для разрешения.The PeerName to resolve.

maxRecords
Int32

Максимальное число записей для получения имени однорангового узла.The maximum number of records to obtain for the Peer Name.

userState
Object

Определяемый пользователем объект, содержащий сведения об операции разрешения.A user-defined object that contains information about the resolve operation.

Исключения

Хотя бы одному параметру (peerName или userState) присвоено значение null.One or both of the peerName and userState parameters are set to null.

Значение параметра maxRecords меньше или равно нулю.The maxRecords parameter is less than or equal to zero.

Комментарии

Этот метод асинхронно связывает имя однорангового узла с облаками.This method asynchronously associates a peer name to clouds. Все облака запрашиваются для PeerName.All clouds are queried for the PeerName. Для незащищенных имен одноранговых узлов одно и то же имя можно зарегистрировать (и связать с разными конечными точками) разными одноранговыми узлами в одном облаке.For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud. Если имя однорангового узла не может быть nullразрешено PeerToPeerException или равно, создается исключение.If the peer name cannot be resolved or is null, an PeerToPeerException is thrown.

Этот метод вызывает ResolveCompleted событие, которое выполняет обратный вызов OnResolveCompleted к методу.This method raises the ResolveCompleted event, which calls back to the OnResolveCompleted method. Или вызывает ResolveProgressChanged событие, которое вызывает OnResolveProgressChanged метод.Or, it raises the ResolveProgressChanged event, which calls back to the OnResolveProgressChanged method.

Для каждого ResolveAsync метода существует эквивалентный Resolve метод.For every ResolveAsync method, there is an equivalent Resolve method. Их списки параметров идентичны, за исключением того, что метод Ресолвеасинк включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing.

Все асинхронные ссылки на объект сопоставителя координируются с помощью уникального маркера Objectидентификатора.All asynchronous references to the resolver object are coordinated with a unique identifier token Object. Этот userState маркер или идентификатор сообщения позволяет операционной системе доставлять сообщения одному процессу приема после помещения сообщения в очередь сообщений.This userState token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue.

ResolveCompleted Событие будет вызвано, если операция разрешения завершилась с ошибкой или отменена.The ResolveCompleted event will be raised if the resolve operation completes in error or is canceled.

ResolveAsync(PeerName, Cloud, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud.Begins an asynchronous peer name resolution operation for the specified PeerName in the specified Cloud.

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

Параметры

peerName
PeerName

Имя PeerName для разрешения.The PeerName to resolve.

cloud
Cloud

В Cloud необходимо разрешить peerName.The Cloud in which to resolve the peerName.

userState
Object

Определяемый пользователем объект Object, который содержит сведения об операции разрешения имени однорангового узла.A user-defined Object that contains information about the peer name resolution operation.

Исключения

Хотя бы одному параметру (peerName или userState) присвоено значение null.One or both of the peerName and userState parameters are set to null.

Комментарии

Этот метод вызывает ResolveCompleted событие, которое выполняет обратный вызов OnResolveCompleted к методу.This method raises the ResolveCompleted event, which calls back to the OnResolveCompleted method. Или вызывает ResolveProgressChanged событие, которое вызывает OnResolveProgressChanged метод.Or, it raises the ResolveProgressChanged event, which calls back to the OnResolveProgressChanged method.

Для незащищенных имен одноранговых узлов одно и то же имя можно зарегистрировать (и связать с разными конечными точками) разными одноранговыми узлами в одном облаке.For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud.

Name Available Scope ScopeId Если параметр имеет значение null, имя разрешается с помощью ярлыка, который инициализирует значения по умолчанию для свойств, и. CloudIf the Cloud parameter is null, the name is resolved using the Available shortcut, which initializes default values for the Name, Scope, and ScopeId properties.

Для каждого ResolveAsync метода существует эквивалентный Resolve метод.For every ResolveAsync method, there is an equivalent Resolve method. Их списки параметров идентичны, за исключением того, что метод Ресолвеасинк включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing.

Все асинхронные ссылки на объект сопоставителя координируются с помощью уникального маркера идентификатора.All asynchronous references to the resolver object are coordinated with a unique identifier token. Этот userState маркер или идентификатор сообщения позволяет операционной системе доставлять сообщения одному процессу приема после помещения сообщения в очередь сообщений.This userState token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue.

ResolveCompleted Событие будет вызвано, если операция разрешения завершилась с ошибкой или отменена.The ResolveCompleted event will be raised if the resolve operation completes in error or is canceled.

ResolveAsync(PeerName, Cloud, Int32, Object)

Начинает операцию асинхронного разрешения имени однорангового узла для заданного значения PeerName в указанном классе Cloud.Begins an asynchronous peer name resolution operation for the specified PeerName in the specified Cloud. Для указанного имени однорангового узла соответствующая операция разрешит не более такого количества записей: maxRecords.The resolution operation will resolve no more than maxRecords entries for the specified peer name.

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);
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * int * obj -> unit

Параметры

peerName
PeerName

Имя peerName для разрешения.The peerName to resolve.

cloud
Cloud

Объект cloud, в котором необходимо разрешить peerName.The cloud in which to resolve peerName.

maxRecords
Int32

Максимальное число записей для получения из параметра cloud для peerName.The maximum number of records to obtain from cloud for peerName.

userState
Object

Определяемый пользователем объект, содержащий сведения об операции разрешения имени однорангового узла.A user-defined object that contains information about the peer name resolution operation.

Атрибуты

Исключения

Хотя бы одному параметру (peerName или userState) присвоено значение null.One or both of the peerName and userState parameters are set to null.

Один или несколько указанных параметров недопустимы.One or more supplied parameters are invalid.

Чтобы успешно завершить эту операцию, требуется по крайней мере один обработчик событий.Successful completion of this operation requires at least one event handler.

Значение параметра maxRecords меньше или равно нулю.The maxRecords parameter is less than or equal to zero.

Комментарии

Для незащищенных имен одноранговых узлов одно и то же имя можно зарегистрировать (и связать с разными конечными точками) разными одноранговыми узлами в одном облаке.For unsecured peer names, the same name can be registered (and associated with different endpoints) by different peers within the same cloud.

Этот метод вызывает ResolveCompleted событие, которое выполняет обратный вызов OnResolveCompleted к методу.This method raises the ResolveCompleted event, which calls back to the OnResolveCompleted method. Или вызывает ResolveProgressChanged событие, которое вызывает OnResolveProgressChanged метод.Or, it raises the ResolveProgressChanged event, which calls back to the OnResolveProgressChanged method.

Name Available Scope ScopeId Если параметр имеет значение null, имя разрешается с помощью ярлыка, который инициализирует значения по умолчанию для свойств, и. CloudIf the Cloud parameter is null, the name is resolved using the Available shortcut, which initializes default values for the Name, Scope, and ScopeId properties.

Для каждого ResolveAsync метода существует эквивалентный Resolve метод.For every ResolveAsync method, there is an equivalent Resolve method. Их списки параметров идентичны, за исключением того, что метод Ресолвеасинк включает системный маркер для асинхронной обработки событий, а метод Resolve предназначен для синхронной обработки.Their parameter lists are identical, except that the ResolveAsync method includes a system token for asynchronous event handling, and the Resolve method is intended for synchronous processing.

Все асинхронные ссылки на объект распознавателя одноранговых узлов координируются с помощью уникального Objectмаркера идентификатора.All asynchronous references to the peer resolver object are coordinated with a unique identifier token Object. Этот userState маркер или идентификатор сообщения позволяет операционной системе доставлять сообщения одному процессу приема после помещения сообщения в очередь сообщений.This userState token or message identifier allows an operating system to deliver a message to a single receiving process after the message has been placed on the message queue.

ResolveCompleted Событие будет вызвано, если операция разрешения завершилась с ошибкой или отменена.The ResolveCompleted event will be raised if the resolve operation completes in error or is canceled.

Применяется к