SOCKADDR_IN6_LH structure (ws2ipdef.h)

Article
03/04/2024

La structure SOCKADDR_IN6 spécifie une adresse de transport et un port pour la famille d’adresses AF_INET6 .

Syntaxe

typedef struct sockaddr_in6 {
  ADDRESS_FAMILY sin6_family;
  USHORT         sin6_port;
  ULONG          sin6_flowinfo;
  IN6_ADDR       sin6_addr;
  union {
    ULONG    sin6_scope_id;
    SCOPE_ID sin6_scope_struct;
  };
} SOCKADDR_IN6_LH, *PSOCKADDR_IN6_LH, *LPSOCKADDR_IN6_LH;

Membres

sin6_family

Famille d’adresses pour l’adresse de transport. Ce membre doit toujours être défini sur AF_INET6.

sin6_port

Numéro de port du protocole de transport.

sin6_flowinfo

Informations de flux IPv6.

sin6_addr

Structure IN6_ADDR qui contient une adresse de transport IPv6.

sin6_scope_id

Représentation ULONG de l’identificateur d’étendue IPv6 défini dans le membre sin6_scope_struct .

sin6_scope_struct

Structure SCOPE_ID qui contient l’identificateur d’étendue de l’adresse de transport IPv6. La structure SCOPE_ID est définie comme suit :

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

Zone

Index de zone qui identifie la zone à laquelle se rapporte l’adresse de transport. Les zones des différentes étendues sont instanciées comme suit :

Chaque interface sur un nœud comprend une seule zone d’étendue locale d’interface.

Chaque lien et les interfaces attachées à ce lien constituent une seule zone d’étendue locale de lien.

Il existe une seule zone d’étendue globale qui comprend tous les liens et interfaces dans Internet.

Les limites des zones d’étendue autres que l’interface locale, la liaison locale et la global sont définies par les administrateurs réseau.

La valeur zéro spécifie la zone par défaut.

Level

Étendue de l’adresse de transport IPv6. Cette étendue doit être identique à la valeur d’étendue IPv6 incorporée dans l’adresse de transport IPv6. Ce membre peut être l’un des éléments suivants :

ScopeLevelInterface

L’adresse de transport a une étendue locale d’interface.

ScopeLevelLink

L’adresse de transport a une étendue locale de lien.

ScopeLevelSubnet

L’adresse de transport a une étendue locale de sous-réseau.

ScopeLevelAdmin

L’adresse de transport a une étendue locale d’administrateur.

ScopeLevelSite

L’adresse de transport a une étendue locale de site.

ScopeLevelOrganization

L’adresse de transport a organization portée locale.

ScopeLevelGlobal

L’adresse de transport a une étendue globale.

Valeur

Représentation ULONG de l’identificateur d’étendue IPv6.

Remarques

Toutes les données de la structure SOCKADDR_IN6, à l’exception de la famille d’adresses, doivent être spécifiées dans l’ordre d’octets réseau (big-endian).

La taille de la structure SOCKADDR_IN6 est trop grande pour tenir dans l’espace mémoire fourni par une structure SOCKADDR . Pour une structure dont la taille est garantie suffisante pour contenir une adresse de transport pour toutes les familles d’adresses possibles, consultez SOCKADDR_STORAGE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	ws2ipdef.h (include Ws2ipdef.h)