IPGlobalProperties.GetUnicastAddresses Methode

Definition

Ruft die Tabelle der statischen Unicast-IP-Adressen auf dem lokalen Computer ab.

public:
 virtual System::Net::NetworkInformation::UnicastIPAddressInformationCollection ^ GetUnicastAddresses();
public virtual System.Net.NetworkInformation.UnicastIPAddressInformationCollection GetUnicastAddresses ();
abstract member GetUnicastAddresses : unit -> System.Net.NetworkInformation.UnicastIPAddressInformationCollection
override this.GetUnicastAddresses : unit -> System.Net.NetworkInformation.UnicastIPAddressInformationCollection
Public Overridable Function GetUnicastAddresses () As UnicastIPAddressInformationCollection

Gibt zurück

Ein UnicastIPAddressInformationCollection, das eine Liste der statischen Unicast-IP-Adressen auf dem lokalen Computer enthält.

Ausnahmen

Der Aufruf der systemeigenen GetAdaptersAddresses-Funktion ist fehlgeschlagen.

Diese Methode wird auf der Plattform nicht implementiert. Diese Methode verwendet die systemeigene NotifyStableUnicastIpAddressTable-Funktion, die unter Windows Vista und höher unterstützt wird.

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 GetUnicastAddresses -Methode ermöglicht es einer Anwendung, die Liste der stabilen Unicast-IP-Adressen 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.

Gilt für:

Weitere Informationen