IPGlobalProperties.GetUnicastAddressesAsync Método

Definición

Recupera la tabla de direcciones IP de unidifusión estables del equipo local como una operación asincrónica.

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)

Devoluciones

Objeto de tarea que representa la operación asincrónica.

Excepciones

Se ha producido un error en la llamada a la función GetAdaptersAddresses nativa.

El llamador no dispone del permiso Read requerido.

Se ha producido un error en la llamada a la función NotifyStableUnicastIpAddressTable nativa.

Comentarios

Para admitir conexiones salientes o para aceptar conexiones entrantes en una interfaz Teredo, las aplicaciones deben asegurarse de que la interfaz teredo esté lista para su uso. Esto se debe a que Teredo puede entrar en un estado inactivo cuando no se usa durante algún período de tiempo.

El GetUnicastAddressesAsync método permitirá que una aplicación recupere la lista de direcciones IP de unidifusión estables como operación asincrónica. La IPAddress.IsIPv6Teredo propiedad se puede usar para determinar si una dirección IP es una dirección Teredo IPv6 con el prefijo 2001::/32.

El GetUnicastAddresses método también devuelve direcciones que no son Teredo y proporciona una manera más cómoda de obtener las direcciones IP de unidifusión para un sistema que enumerar todos los System.Net.NetworkInformation.NetworkInterface objetos de un equipo local y consultar las direcciones IP asociadas.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por GetUnicastAddresses().

Se aplica a

Consulte también