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 stabile Unicast-IP-Adresstabelle 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
Fehler beim Aufruf der systemeigenen GetAdaptersAddresses Funktion.
Der Aufrufer verfügt nicht über die erforderliche Read Berechtigung.
Fehler beim Aufruf der systemeigenen NotifyStableUnicastIpAddressTable Funktion.
Hinweise
Um ausgehende Verbindungen zu unterstützen oder eingehende Verbindungen auf einer Teredo-Schnittstelle zu akzeptieren, müssen Anwendungen sicherstellen, dass die Teredo-Schnittstelle aktiviert und einsatzbereit ist. Dies liegt daran, dass Teredo in einen ruhenden Zustand versetzt werden kann, wenn er für einen bestimmten Zeitraum nicht verwendet wird.
Mit der GetUnicastAddressesAsync Methode kann eine Anwendung die Liste der stabilen Unicast-IP-Adressen als asynchronen Vorgang abrufen. Mit der IPAddress.IsIPv6Teredo Eigenschaft kann ermittelt werden, ob es sich bei einer IP-Adresse um eine IPv6-Teredo-Adresse mit dem Präfix 2001:::/32 handelt.
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 aufzuzählen und die zugehörigen IP-Adressen abzufragen.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von GetUnicastAddresses().
