IP_ADAPTER_UNICAST_ADDRESS_XP-Struktur (iptypes.h)

Artikel
08/24/2023

Die IP_ADAPTER_UNICAST_ADDRESS-Struktur speichert eine einzelne Unicast-IP-Adresse in einer verknüpften Liste von IP-Adressen für einen bestimmten Adapter.

Syntax

typedef struct _IP_ADAPTER_UNICAST_ADDRESS_XP {
  union {
    ULONGLONG Alignment;
    struct {
      ULONG Length;
      DWORD Flags;
    };
  };
  struct _IP_ADAPTER_UNICAST_ADDRESS_XP *Next;
  SOCKET_ADDRESS                        Address;
  IP_PREFIX_ORIGIN                      PrefixOrigin;
  IP_SUFFIX_ORIGIN                      SuffixOrigin;
  IP_DAD_STATE                          DadState;
  ULONG                                 ValidLifetime;
  ULONG                                 PreferredLifetime;
  ULONG                                 LeaseLifetime;
} IP_ADAPTER_UNICAST_ADDRESS_XP, *PIP_ADAPTER_UNICAST_ADDRESS_XP;

Members

Alignment

Typ: ULONGLONG

Reserviert. Wird vom Compiler verwendet, um die Struktur auszurichten.

Length

Typ: ULONG

Die Länge dieser Struktur in Bytes.

Flags

Art: DWORD

Ein Satz von Flags für diese IP-Adresse.

In der folgenden Tabelle sind die möglichen Werte aufgeführt. Diese Konstanten werden in der Headerdatei Iptypes.h definiert.

Wert	Bedeutung
IP_ADAPTER_ADDRESS_DNS_ELIGIBLE	Die IP-Adresse ist zulässig, um im DNS angezeigt zu werden.
IP_ADAPTER_ADDRESS_TRANSIENT	Die IP-Adresse ist eine Clusteradresse und sollte von den meisten Anwendungen nicht verwendet werden.

Next

Typ: Struktur _IP_ADAPTER_UNICAST_ADDRESS*

Ein Zeiger auf die nächste IP-Adapter-Adressstruktur in der Liste.

Address

Typ: SOCKET_ADDRESS

Die IP-Adresse für diesen Unicast-IP-Adresseintrag. Bei diesem Member kann es sich um eine IPv6-Adresse oder eine IPv4-Adresse handeln.

PrefixOrigin

Typ: IP_PREFIX_ORIGIN

Das Präfix oder der Netzwerkteil der IP-Adresse. Dieser Member kann einer der Werte aus dem IP_PREFIX_ORIGIN Enumerationstyp sein, der in der Iptypes.h-Headerdatei definiert ist.

SuffixOrigin

Typ: IP_SUFFIX_ORIGIN

Das Suffix oder der Hostteil der IP-Adresse. Dieser Member kann einer der Werte aus dem IP_SUFFIX_ORIGIN Enumerationstyp sein, der in der Iptypes.h-Headerdatei definiert ist.

DadState

Typ: IP_DAD_STATE

Der DaD-Zustand (Duplicate Address Detection, Duplikaterkennung). Dieser Member kann einer der Werte aus dem IP_DAD_STATE Enumerationstyp sein, der in der Iptypes.h-Headerdatei definiert ist. Die Erkennung doppelter Adressen ist sowohl für IPv4- als auch für IPv6-Adressen verfügbar.

ValidLifetime

Typ: ULONG

Die maximale Lebensdauer in Sekunden, für die die IP-Adresse gültig ist. Ein Wert von 0xffffffff gilt als unendlich.

PreferredLifetime

Typ: ULONG

Die bevorzugte Lebensdauer in Sekunden, für die die IP-Adresse gültig ist. Ein Wert von 0xffffffff gilt als unendlich.

LeaseLifetime

Typ: ULONG

Die Leaselebensdauer in Sekunden, in der die IP-Adresse gültig ist.

Hinweise

Die IP_ADAPTER_ADDRESSES-Struktur wird von der GetAdaptersAddresses-Funktion abgerufen. Das FirstUnicastAddress-Element der IP_ADAPTER_ADDRESSES-Struktur ist ein Zeiger auf eine verknüpfte Liste von IP_ADAPTER_UNICAST_ADDRESS-Strukturen .

Die Größe der IP_ADAPTER_UNICAST_ADDRESS-Struktur wurde unter Windows Vista und höher geändert. Der Length-Member sollte verwendet werden, um zu bestimmen, welche Version der IP_ADAPTER_UNICAST_ADDRESS-Struktur verwendet wird.

Der Version der IP_ADAPTER_UNICAST_ADDRESS-Struktur unter Windows Vista und höher wurde das folgende neue Element hinzugefügt: OnLinkPrefixLength.

Wenn diese Struktur mit der GetAdaptersAddresses-Funktion und ähnlichen Verwaltungsfunktionen verwendet wird, werden alle konfigurierten Adressen einschließlich doppelter Adressen angezeigt. Solche doppelten Adresseinträge können auftreten, wenn Adressen statisch konfiguriert werden. Eine solche Berichterstellung erleichtert die Problembehandlung für Administratoren. Das DadState-Element ist effektiv bei der Identifizierung und Problembehandlung solcher Situationen.

Im Windows SDK ist die Version der Struktur für die Verwendung unter Windows Vista und höher als IP_ADAPTER_UNICAST_ADDRESS_LH definiert. Im Windows SDK wird die Version dieser Struktur, die auf früheren Systemen verwendet werden soll, einschließlich Windows XP mit Service Pack 1 (SP1) und höher, als IP_ADAPTER_UNICAST_ADDRESS_XP definiert. Wenn eine Anwendung kompiliert wird, wenn die Zielplattform Windows Vista und höher (NTDDI_VERSION >= NTDDI_VISTA, oderWINVER >= 0x0600) ist, _WIN32_WINNT >= 0x0600wird die IP_ADAPTER_UNICAST_ADDRESS_LH-Struktur in die IP_ADAPTER_UNICAST_ADDRESS-Struktur typisiert. Wenn eine Anwendung kompiliert wird, wenn die Zielplattform nicht Windows Vista und höher ist, wird die IP_ADAPTER_UNICAST_ADDRESS_XP-Struktur in die IP_ADAPTER_UNICAST_ADDRESS-Struktur typisiert.

Die SOCKET_ADDRESS-Struktur wird in der IP_ADAPTER_UNICAST_ADDRESS-Struktur verwendet. Im Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, wurde die organization von Headerdateien geändert, und die SOCKET_ADDRESS-Struktur wird in der Ws2def.h-Headerdatei definiert, die automatisch in der Winsock2.h-Headerdatei enthalten ist. Im Platform Software Development Kit (SDK), das für Windows Server 2003 und Windows XP veröffentlicht wurde, wird die SOCKET_ADDRESS-Struktur in der Winsock2.h-Headerdatei deklariert. Um die IP_ADAPTER_UNICAST_ADDRESS-Struktur verwenden zu können, muss die Winsock2.h-Headerdatei vor der Headerdatei Iphlpapi.h eingeschlossen werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	iptypes.h (include Iphlpapi.h)