IPGlobalProperties.GetUnicastAddressesAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Haalt de stabiele unicast-IP-adrestabel op de lokale computer op als asynchrone bewerking.
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)Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De aanroep van de systeemeigen GetAdaptersAddresses functie is mislukt.
De beller beschikt niet over de benodigde Read machtigingen.
De aanroep van de systeemeigen NotifyStableUnicastIpAddressTable functie is mislukt.
Opmerkingen
Om uitgaande verbindingen te ondersteunen of binnenkomende verbindingen op een Teredo-interface te accepteren, moeten toepassingen ervoor zorgen dat de Teredo-interface gereed is voor gebruik. Dit komt doordat Teredo in slaapstand kan gaan wanneer deze gedurende een bepaalde periode niet wordt gebruikt.
Met GetUnicastAddressesAsync de methode kan een toepassing de lijst met stabiele unicast-IP-adressen ophalen als asynchrone bewerking. De IPAddress.IsIPv6Teredo eigenschap kan worden gebruikt om te bepalen of een IP-adres een IPv6 Teredo-adres is met het voorvoegsel 2001::/32.
De GetUnicastAddresses methode retourneert ook niet-Teredo-adressen en biedt een handigere manier om de unicast-IP-adressen voor een systeem te verkrijgen dan alle System.Net.NetworkInformation.NetworkInterface objecten op een lokale computer op te sommen en de bijbehorende IP-adressen op te vragen.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door GetUnicastAddresses()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.