IPGlobalProperties.GetUnicastAddressesAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera a tabela estável de endereços IP unicast no computador local como uma operação assíncrona.
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)Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
A chamada à função nativa GetAdaptersAddresses falhou.
O interlocutor não tem a permissão necessária Read .
A chamada à função nativa NotifyStableUnicastIpAddressTable falhou.
Observações
Para suportar ligações de saída ou aceitar ligações de entrada numa interface Teredo, as aplicações precisam de garantir que a interface Teredo está ativa e pronta para uso. Isto porque o Teredo pode entrar num estado de dormência quando não é usado durante algum período.
O GetUnicastAddressesAsync método permitirá que uma aplicação recupere a lista de endereços IP unicast estáveis como operação assíncrona. A IPAddress.IsIPv6Teredo propriedade pode ser usada para determinar se um endereço IP é um endereço Teredo IPv6 com o prefixo 2001::/32.
O GetUnicastAddresses método também devolve endereços não-Teredo e oferece uma forma mais conveniente de obter os endereços IP unicast de um sistema do que enumerar todos os System.Net.NetworkInformation.NetworkInterface objetos num computador local e consultar os endereços IP associados.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por GetUnicastAddresses().
