Поделиться через


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().

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

См. также раздел