Condividi tramite


IPGlobalProperties.GetUnicastAddressesAsync Metodo

Definizione

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

Si applica a

Vedi anche