IPGlobalProperties.GetUnicastAddressesAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Richiama una tabella di indirizzi IP unicast stabili sul computer locale come operazione asincrona.
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)Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
La chiamata alla funzione GetAdaptersAddresses nativa non è riuscita.
Il chiamante non dispone dell'autorizzazione Read necessaria.
La chiamata alla funzione NotifyStableUnicastIpAddressTable nativa non è riuscita.
Commenti
Per supportare le connessioni in uscita o accettare connessioni in ingresso in un'interfaccia Teredo, le applicazioni devono assicurarsi che l'interfaccia Teredo sia pronta per l'uso. Ciò è dovuto al fatto che Teredo può entrare in uno stato inattivo quando non viene usato per un certo periodo di tempo.
Il GetUnicastAddressesAsync metodo consentirà a un'applicazione di recuperare l'elenco di indirizzi IP unicast stabili come operazione asincrona. La IPAddress.IsIPv6Teredo proprietà può essere usata per determinare se un indirizzo IP è un indirizzo IPv6 Teredo con il prefisso 2001::/32.
Il GetUnicastAddresses metodo restituisce anche indirizzi non Teredo e offre un modo più pratico per ottenere gli indirizzi IP unicast per un sistema rispetto all'enumerazione di tutti gli System.Net.NetworkInformation.NetworkInterface oggetti in un computer locale ed eseguire query sugli indirizzi IP associati.
Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da GetUnicastAddresses().
