structure IP_ADAPTER_UNICAST_ADDRESS_LH (iptypes.h)
La structure IP_ADAPTER_UNICAST_ADDRESS stocke une adresse IP unique dans une liste liée d’adresses IP pour une carte particulière.
Syntaxe
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;
Membres
Alignment
Length
Type : ULONG
Longueur, en octets, de cette structure.
Flags
Type : DWORD
Ensemble d’indicateurs pour cette adresse IP.
La table suivante indique des valeurs possibles. Ces constantes sont définies dans le fichier d’en-tête Iptypes.h .
Next
Type : struct _IP_ADAPTER_UNICAST_ADDRESS*
Pointeur vers la structure d’adresse de l’adaptateur IP suivante dans la liste.
Address
Type : SOCKET_ADDRESS
Adresse IP de cette entrée d’adresse IP unicast. Ce membre peut être une adresse IPv6 ou une adresse IPv4.
PrefixOrigin
Type : IP_PREFIX_ORIGIN
Préfixe ou partie réseau de l’adresse IP. Ce membre peut être l’une des valeurs du type d’énumération IP_PREFIX_ORIGIN défini dans le fichier d’en-tête Iptypes.h .
SuffixOrigin
Type : IP_SUFFIX_ORIGIN
Suffixe ou partie hôte de l’adresse IP. Ce membre peut être l’une des valeurs du type d’énumération IP_SUFFIX_ORIGIN défini dans le fichier d’en-tête Iptypes.h .
DadState
Type : IP_DAD_STATE
État de détection d’adresse dupliquée (DAD). Ce membre peut être l’une des valeurs du type d’énumération IP_DAD_STATE défini dans le fichier d’en-tête Iptypes.h . La détection d’adresses en double est disponible pour les adresses IPv4 et IPv6.
ValidLifetime
Type : ULONG
Durée de vie maximale, en secondes, pendant laquelle l’adresse IP est valide. Une valeur de 0xffffffff est considérée comme infinie.
PreferredLifetime
Type : ULONG
Durée de vie préférée, en secondes, pendant laquelle l’adresse IP est valide. Une valeur de 0xffffffff est considérée comme infinie.
LeaseLifetime
Type : ULONG
Durée de vie du bail, en secondes, pour laquelle l’adresse IP est valide.
OnLinkPrefixLength
Type : UINT8
Longueur, en bits, du préfixe ou de la partie réseau de l’adresse IP. Pour une adresse IPv4 unicast, toute valeur supérieure à 32 est une valeur non valide. Pour une adresse IPv6 unicast, toute valeur supérieure à 128 est une valeur non valide. Une valeur de 255 est couramment utilisée pour représenter une valeur non valide.
Notes
La structure IP_ADAPTER_ADDRESSES est récupérée par la fonction GetAdaptersAddresses . Le membre FirstUnicastAddress de la structure IP_ADAPTER_ADDRESSES est un pointeur vers une liste liée de structures IP_ADAPTER_UNICAST_ADDRESS .
La taille de la structure IP_ADAPTER_UNICAST_ADDRESS a changé sur Windows Vista et versions ultérieures. Le membre Length doit être utilisé pour déterminer quelle version de la structure IP_ADAPTER_UNICAST_ADDRESS est utilisée.
Le nouveau membre suivant est ajouté à la version de la structure IP_ADAPTER_UNICAST_ADDRESS sur Windows Vista et versions ultérieures : OnLinkPrefixLength.
Lorsque cette structure est utilisée avec la fonction GetAdaptersAddresses et des fonctions de gestion similaires, toutes les adresses configurées sont affichées, y compris les adresses en double. Ces entrées d’adresses en double peuvent se produire lorsque les adresses sont configurées de manière statique. Ces rapports facilitent la résolution des problèmes d’administrateur. Le membre DadState est efficace pour identifier et résoudre de telles situations.
Dans le Kit de développement logiciel (SDK) Windows, la version de la structure à utiliser sur Windows Vista et versions ultérieures est définie comme IP_ADAPTER_UNICAST_ADDRESS_LH. Dans le Kit de développement logiciel (SDK) Windows, la version de cette structure à utiliser sur les systèmes antérieurs, y compris Windows XP avec Service Pack 1 (SP1) et versions ultérieures, est définie comme IP_ADAPTER_UNICAST_ADDRESS_XP. Lors de la compilation d’une application si la plateforme cible est Windows Vista et versions ultérieures (NTDDI_VERSION >= NTDDI_VISTA
, _WIN32_WINNT >= 0x0600
, ou WINVER >= 0x0600
), la structure IP_ADAPTER_UNICAST_ADDRESS_LH est typée à la structure IP_ADAPTER_UNICAST_ADDRESS . Lors de la compilation d’une application si la plateforme cible n’est pas Windows Vista et versions ultérieures, la structure IP_ADAPTER_UNICAST_ADDRESS_XP est typée à la structure IP_ADAPTER_UNICAST_ADDRESS .
La structure SOCKET_ADDRESS est utilisée dans la structure IP_ADAPTER_UNICAST_ADDRESS . Dans le Kit de développement logiciel (SDK) Microsoft Windows publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé et la structure SOCKET_ADDRESS est définie dans le fichier d’en-tête Ws2def.h qui est automatiquement inclus par le fichier d’en-tête Winsock2.h. Dans le Kit de développement logiciel (SDK) de plateforme publié pour Windows Server 2003 et Windows XP, la structure SOCKET_ADDRESS est déclarée dans le fichier d’en-tête Winsock2.h . Pour utiliser la structure IP_ADAPTER_UNICAST_ADDRESS , le fichier d’en-tête Winsock2.h doit être inclus avant le fichier d’en-tête Iphlpapi.h .
Spécifications
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
En-tête | iptypes.h (inclure Iphlpapi.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour