union SOCKADDR_INET (ws2ipdef.h)

Article
03/04/2024

L’union SOCKADDR_INET contient une adresse IPv4, une adresse IPv6 ou une famille d’adresses.

Syntaxe

typedef union _SOCKADDR_INET {
  SOCKADDR_IN    Ipv4;
  SOCKADDR_IN6   Ipv6;
  ADDRESS_FAMILY si_family;
} SOCKADDR_INET, *PSOCKADDR_INET;

Membres

Ipv4

Type : SOCKADDR_IN

Une adresse IPv4 représentée sous la forme d’une structure de SOCKADDR_IN contenant la famille d’adresses et l’adresse IPv4. La famille d’adresses est dans l’ordre des octets de l’hôte et l’adresse IPv4 est dans l’ordre d’octet réseau.

Sur le SDK Windows publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé et la structure SOCKADDR_IN est définie dans le fichier d’en-tête Ws2def.h. Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.h et ne doit jamais être utilisé directement.

Ipv6

Type : SOCKADDR_IN6

Une adresse IPv6 représentée sous la forme d’une structure de SOCKADDR_IN6 contenant la famille d’adresses et l’adresse IPv6. La famille d’adresses est dans l’ordre des octets de l’hôte et l’adresse IPv6 est dans l’ordre d’octets réseau.

Sur le SDK Windows publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé et la structure SOCKADDR_IN6 est définie dans le fichier d’en-tête Ws2def.h. Notez que le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.h et ne doit jamais être utilisé directement.

si_family

Type : ADDRESS_FAMILY

Famille d’adresses.

Les valeurs possibles pour la famille d’adresses sont répertoriées dans le fichier d’en-tête Ws2def.h . Notez que les valeurs de la famille d’adresses AF_ et des constantes de famille de protocole PF_ sont identiques (par exemple , AF_INET et PF_INET), de sorte que l’une ou l’autre constante peut être utilisée. Le fichier d’en-tête Ws2def.h est automatiquement inclus dans Winsock2.h et ne doit jamais être utilisé directement.

Les valeurs actuellement prises en charge sont AF_INET, AF_INET6 et AF_UNSPEC.

Valeur	Signification
AF_UNSPEC 0	La famille d’adresses n’est pas spécifiée. Lorsque ce paramètre est spécifié, l’union SOCKADDR_INET peut représenter la famille d’adresses IPv4 ou IPv6.
AF_INET 2	Famille d’adresses IPv4 (Internet Protocol version 4).
AF_INET6 23	Famille d’adresses IPv6 (Internet Protocol version 6).

Remarques

L’union SOCKADDR_INET est définie sur Windows Vista et versions ultérieures.

L’union SOCKADDR_INET est une structure pratique permettant d’accéder à une adresse IPv4, à une adresse IPv6 ou à la famille d’adresses IP sans avoir à convertir la structure sockaddr.

L’union SOCKADDR_INET est le type de données du membre Prefix dans la structure IP_ADDRESS_PREFIX

Notez que le fichier d’en-tête Ws2ipdef.h est automatiquement inclus dans le fichier d’en-tête Ws2tcpip.h et ne doit jamais être utilisé directement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	ws2ipdef.h (include Ws2tcpip.h)

Voir aussi

IP_ADDRESS_PREFIX

sockaddr

Partager via