IPGlobalProperties.GetUnicastAddressesAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar den stabila unicast-IP-adresstabellen på den lokala datorn som en asynkron åtgärd.
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)
Returer
Aktivitetsobjektet som representerar den asynkrona åtgärden.
Undantag
Anropet till den interna GetAdaptersAddresses funktionen misslyckades.
Anroparen har inte nödvändig Read behörighet.
Anropet till den interna NotifyStableUnicastIpAddressTable funktionen misslyckades.
Kommentarer
För att stödja utgående anslutningar eller för att acceptera inkommande anslutningar i ett Teredo-gränssnitt måste programmen se till att Teredo-gränssnittet är klart för användning. Detta beror på att Teredo kan gå in i ett vilande tillstånd när det inte används under en viss tidsperiod.
Med GetUnicastAddressesAsync metoden kan ett program hämta listan över stabila unicast-IP-adresser som asynkron åtgärd. Egenskapen IPAddress.IsIPv6Teredo kan användas för att avgöra om en IP-adress är en IPv6 Teredo-adress med prefixet 2001::/32.
Metoden GetUnicastAddresses returnerar även icke-Teredo-adresser och ger ett bekvämare sätt att hämta unicast-IP-adresserna för ett system än att räkna upp alla System.Net.NetworkInformation.NetworkInterface objekt på en lokal dator och köra frågor mot de associerade IP-adresserna.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av GetUnicastAddresses().