IP_ADAPTER_UNICAST_ADDRESS_LH-Struktur (iptypes.h)
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_LH {
union {
ULONGLONG Alignment;
struct {
ULONG Length;
DWORD Flags;
};
};
struct _IP_ADAPTER_UNICAST_ADDRESS_LH *Next;
SOCKET_ADDRESS Address;
IP_PREFIX_ORIGIN PrefixOrigin;
IP_SUFFIX_ORIGIN SuffixOrigin;
IP_DAD_STATE DadState;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG LeaseLifetime;
UINT8 OnLinkPrefixLength;
} IP_ADAPTER_UNICAST_ADDRESS_LH, *PIP_ADAPTER_UNICAST_ADDRESS_LH;
Members
Alignment
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.
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.
OnLinkPrefixLength
Typ: UINT8
Die Länge des Präfixes oder des Netzwerkteils der IP-Adresse in Bits. Für eine Unicast-IPv4-Adresse ist jeder Wert größer als 32 ein unzulässiger Wert. Für eine Unicast-IPv6-Adresse ist jeder Wert größer als 128 ein unzulässiger Wert. Der Wert 255 wird häufig verwendet, um einen unzulässigen Wert darzustellen.
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 >= 0x0600
wird 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) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für