Udostępnij za pośrednictwem


IPGlobalProperties.GetUnicastAddressesAsync Metoda

Definicja

Pobiera stabilną tabelę adresów IP emisji pojedynczej na komputerze lokalnym jako operację asynchroniczną.

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)

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Wywołanie funkcji natywnej GetAdaptersAddresses nie powiodło się.

Obiekt wywołujący nie ma niezbędnych Read uprawnień.

Wywołanie funkcji natywnej NotifyStableUnicastIpAddressTable nie powiodło się.

Uwagi

Aby obsługiwać połączenia wychodzące lub akceptować połączenia przychodzące w interfejsie teredo, aplikacje muszą upewnić się, że interfejs Teredo jest gotowy do użycia. Dzieje się tak, ponieważ Teredo może przejść do stanu uśpionego, gdy nie jest używany przez pewien okres czasu.

Metoda GetUnicastAddressesAsync umożliwi aplikacji pobranie listy stabilnych adresów IP emisji pojedynczej jako operacji asynchronicznej. Właściwość IPAddress.IsIPv6Teredo może służyć do określenia, czy adres IP jest adresem IPv6 Teredo z prefiksem 2001::/32.

Metoda GetUnicastAddresses zwraca również adresy inne niż Teredo i zapewnia wygodniejszy sposób uzyskiwania adresów IP emisji pojedynczej dla systemu niż wyliczanie wszystkich System.Net.NetworkInformation.NetworkInterface obiektów na komputerze lokalnym i wykonywanie zapytań dotyczących skojarzonych adresów IP.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez GetUnicastAddresses()usługę .

Dotyczy

Zobacz też