IPGlobalProperties.GetUnicastAddressesAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает стабильную таблицу IP-адресов одноадресной рассылки на локальном компьютере в виде асинхронной операции.
public:
virtual System::Threading::Tasks::Task<System::Net::NetworkInformation::UnicastIPAddressInformationCollection ^> ^ GetUnicastAddressesAsync();public virtual System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection> GetUnicastAddressesAsync();abstract member GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
override this.GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>Public Overridable Function GetUnicastAddressesAsync () As Task(Of UnicastIPAddressInformationCollection)Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Сбой вызова собственной GetAdaptersAddresses функции.
Вызывающий объект не имеет необходимых Read разрешений.
Сбой вызова собственной NotifyStableUnicastIpAddressTable функции.
Комментарии
Чтобы поддерживать исходящие подключения или принимать входящие подключения в интерфейсе Teredo, приложения должны убедиться, что интерфейс Teredo готов к использованию. Это связано с тем, что Teredo может перейти в спяющее состояние, если не используется в течение некоторого периода времени.
Этот GetUnicastAddressesAsync метод позволит приложению получить список стабильных ip-адресов одноадресной рассылки в виде асинхронной операции. Это IPAddress.IsIPv6Teredo свойство можно использовать для определения того, является ли IP-адрес IPv6 Teredo адресом с префиксом 2001::/32.
Метод GetUnicastAddresses также возвращает адреса, отличные от Teredo, и предоставляет более удобный способ получения ip-адресов одноадресной рассылки для системы, чем перечисление всех System.Net.NetworkInformation.NetworkInterface объектов на локальном компьютере и запрос связанных IP-адресов.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых GetUnicastAddresses().
