IPGlobalProperties.GetUnicastAddressesAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Tabelle der statischen Unicast-IP-Adressen auf dem lokalen Computer als asynchronen Vorgang ab.
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)Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Der Aufruf der systemeigenen GetAdaptersAddresses-Funktion ist fehlgeschlagen.
Der Aufrufer verfügt nicht über die erforderliche Read-Berechtigung.
Der Aufruf der systemeigenen NotifyStableUnicastIpAddressTable-Funktion ist fehlgeschlagen.
Hinweise
Um ausgehende Verbindungen zu unterstützen oder eingehende Verbindungen auf einer Teredo-Schnittstelle zu akzeptieren, müssen Anwendungen sicherstellen, dass die Teredo-Schnittstelle betriebsbereit und einsatzbereit ist. Dies liegt daran, dass Teredo in einen ruhenden Zustand versetzt werden kann, wenn es für einen bestimmten Zeitraum nicht verwendet wird.
Die GetUnicastAddressesAsync -Methode ermöglicht es einer Anwendung, die Liste der stabilen Unicast-IP-Adressen als asynchronen Vorgang abzurufen. Die IPAddress.IsIPv6Teredo -Eigenschaft kann verwendet werden, um zu bestimmen, ob eine IP-Adresse eine IPv6 Teredo-Adresse mit dem Präfix 2001::/32 ist.
Die GetUnicastAddresses -Methode gibt auch Nicht-Teredo-Adressen zurück und bietet eine bequemere Möglichkeit, die Unicast-IP-Adressen für ein System abzurufen, als alle System.Net.NetworkInformation.NetworkInterface Objekte auf einem lokalen Computer aufzulisten und die zugeordneten IP-Adressen abzufragen.
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden GetUnicastAddresses().
