IPPROTO_IPV6 socket, options
Les tableaux suivants décrivent IPPROTO_IPV6 options de socket qui s’appliquent aux sockets créés pour la famille d’adresses IPv6 (AF_INET6). Pour plus d’informations sur l’obtention et la définition des options de socket, consultez les pages de référence des fonctions getsockopt et setsockopt .
Pour énumérer les protocoles et découvrir les propriétés prises en charge pour chaque protocole installé, utilisez la fonction WSAEnumProtocols, WSCEnumProtocols ou WSCEnumProtocols32 .
Certaines options de socket nécessitent plus d’explications que celles que ces tables peuvent transmettre ; ces options contiennent des liens vers des informations supplémentaires.
Options
| Option | get | set | Type Optval | Description |
|---|---|---|---|---|
| IP_ORIGINAL_ARRIVAL_IF | Oui | Oui | DWORD (booléen) | Indique si la fonction LPFN_WSARECVMSG (WSARecvMsg) doit retourner des données de contrôle facultatives contenant l’interface d’arrivée d’origine où le paquet a été reçu pour les sockets de datagramme. Cette option est utilisée avec les technologies de transition IPv6 (tunnels 6to4, ISATAP et Teredo, par exemple) qui fournissent l’attribution d’adresses et le tunneling automatique d’hôte à hôte pour le trafic IPv6 en monodiffusion lorsque les hôtes IPv6 doivent traverser des réseaux IP4 pour atteindre d’autres réseaux IPv6. Les paquets IPv6 sont « tunnelés » sous la forme de paquets IPv4. Cette option permet à l’interface IPv4 d’origine où le paquet a été reçu d’être retourné dans la structure WSAMSG . |
| IPV6_ADD_IFLIST | Oui | DWORD (IF_INDEX) | Ajoute un index d’interface à l’ifLIST associé à l’option IP_IFLIST . | |
| IPV6_ADD_MEMBERSHIP | Oui | ipv6_mreq | Joignez le socket au groupe de multidiffusion fourni sur l’interface spécifiée. Cette option n’est valide que sur les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). | |
| IPV6_DEL_IFLIST | Oui | DWORD (IF_INDEX) | Supprime un index d’interface de l’ifLIST associé à l’option IP_IFLIST . Les entrées ne peuvent être supprimées que par l’application. Sachez donc que les entrées peuvent être obsolètes une fois qu’une interface est supprimée. | |
| IPV6_DROP_MEMBERSHIP | Oui | ipv6_mreq | Laissez le groupe de multidiffusion fourni de l’interface donnée. Cette option n’est valide que sur les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). | |
| IPV6_GET_IFLIST | Oui | DWORD[] (IF_INDEX[]) | Obtient l’IFLIST actuel associé à l’option IP_IFLIST . Retourne une erreur si IP_IFLIST n’est pas activé. | |
| IPV6_HDRINCL | Oui | Oui | DWORD(boolean) | Indique que l’application fournit l’en-tête IPv6 sur toutes les données sortantes. Si le paramètre optval est défini sur 1 lors de l’appel à setsockopt, l’option est activée. Si optval est défini sur 0, l’option est désactivée. La valeur par défaut est Désactivé. Cette option n’est valide que pour les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). Un fournisseur de services TCP/IP qui prend en charge SOCK_RAW doit également prendre en charge IPV6_HDRINCL. |
| IPV6_HOPLIMIT | Oui | Oui | DWORD (booléen) | Indique que les informations de tronçon (TTL) doivent être retournées dans la fonction LPFN_WSARECVMSG (WSARecvMsg). Si optval est défini sur 1 lors de l’appel à setsockopt, l’option est activée. Si la valeur est 0, l’option est désactivée. Cette option n’est valide que pour les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). |
| IPV6_IFLIST | Oui | Oui | DWORD (booléen) | Obtient ou définit l’état IP_IFLIST du socket. Lorsque cette option a la valeur true, la réception du datagramme est limitée aux interfaces qui se trouvent dans l’IFLIST. Les datagrammes reçus sur d’autres interfaces sont ignorés. IFLIST démarre vide. Utilisez IP_ADD_IFLIST et IP_DEL_IFLIST pour modifier l’IFLIST. |
| IPV6_JOIN_GROUP | Oui | ipv6_mreq | Identique à IPV6_ADD_MEMBERSHIP | |
| IPV6_LEAVE_GROUP | Oui | ipv6_mreq | Identique à IPV6_DROP_MEMBERSHIP | |
| IPV6_MTU | Oui | DWORD | Obtient l’estimation du chemin d’accès MTU par le système. Le socket doit être connecté. | |
| IPV6_MTU_DISCOVER | Oui | Oui | DWORD (PMTUD_STATE) | Obtient ou définit l’état de découverte MTU du chemin d’accès pour le socket. La valeur par défaut est IP_PMTUDISC_NOT_SET. Pour les sockets de flux, IP_PMTUDISC_NOT_SET et IP_PMTUDISC_DO effectuent la découverte MTU du chemin. IP_PMTUDISC_DONT et IP_PMTUDISC_PROBE désactivent la découverte MTU de chemin. Pour les sockets de datagramme, s’il est défini sur IP_PMTUDISC_DO , les tentatives d’envoi de paquets supérieurs au chemin MTU entraînent une erreur. Si la valeur est IP_PMTUDISC_DONT, les paquets sont fragmentés en fonction de l’interface MTU. Si la valeur est IP_PMTUDISC_PROBE, les tentatives d’envoi de paquets supérieurs à l’interface MTU entraînent une erreur. |
| IPV6_MULTICAST_HOPS | Oui | Oui | DWORD | Obtient ou définit la valeur TTL associée au trafic de multidiffusion IPv6 sur le socket. Il est illégal de définir la durée de vie sur une valeur supérieure à 255. Cette option n’est valide que pour les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). |
| IPV6_MULTICAST_IF | Oui | Oui | DWORD | Obtient ou définit l’interface sortante pour l’envoi du trafic de multidiffusion IPv6. Cette option ne modifie pas l’interface par défaut pour la réception du trafic de multidiffusion IPv6. Cette option est importante pour les ordinateurs à plusieurs hébergements. La valeur d’entrée pour la définition de cette option est un index d’interface de 4 octets de l’interface sortante souhaitée dans l’ordre d’octet de l’hôte. La fonction GetAdaptersAddresses peut être utilisée pour obtenir les informations d’index d’interface. Si optval a la valeur NULL lors de l’appel à setsockopt, l’interface IPv6 par défaut est utilisée. Si optval est égal à zéro , l’interface par défaut pour la réception de la multidiffusion est spécifiée pour l’envoi du trafic de multidiffusion. Lors de l’obtention de cette option, optval retourne l’index d’interface par défaut actuel pour l’envoi du trafic IPv6 de multidiffusion dans l’ordre d’octets de l’hôte. |
| IPV6_MULTICAST_LOOP | Oui | Oui | DWORD (booléen) | Indique que les données de multidiffusion envoyées sur le socket seront renvoyées à la mémoire tampon de réception des sockets si elles sont également jointes au groupe de multidiffusion de destination. Si optval est défini sur 1 lors de l’appel à setsockopt, l’option est activée. Si la valeur est 0, l’option est désactivée. Cette option n’est valide que pour les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). |
| IPV6_PKTINFO | Oui | Oui | DWORD (booléen) | Indique que les informations de paquet doivent être retournées par la fonction LPFN_WSARECVMSG (WSARecvMsg). |
| IPV6_PROTECTION_LEVEL | Oui | Oui | INT | Active la restriction d’un socket à une étendue spécifiée, telle que les adresses avec le même lien local ou le même préfixe local de site. Fournit différents niveaux de restriction et paramètres par défaut. Pour plus d’informations, consultez IPV6_PROTECTION_LEVEL . |
| IPV6_RECVIF | Oui | Oui | DWORD (booléen) | Indique si la pile IP doit remplir la mémoire tampon de contrôle avec des détails sur l’interface qui a reçu un paquet avec un socket de datagramme. Lorsque cette valeur est true, la fonction LPFN_WSARECVMSG (WSARecvMsg) retourne des données de contrôle facultatives contenant l’interface où le paquet a été reçu pour les sockets de datagramme. Cette option permet à l’interface IPv6 où le paquet a été reçu d’être retournée dans la structure WSAMSG . Cette option n’est valide que pour les datagrammes et les sockets bruts (le type de socket doit être SOCK_DGRAM ou SOCK_RAW). |
| IPV6_RECVTCLASS | Oui | Oui | DWORD (booléen) | Indique si la pile IP doit remplir la mémoire tampon de contrôle avec un message contenant le champ d’en-tête IPv6 de la classe de trafic sur un datagramme reçu. Lorsque cette valeur est true, la fonction LPFN_WSARECVMSG (WSARecvMsg) retourne des données de contrôle facultatives contenant la valeur de champ d’en-tête IPv6 de la classe de trafic du datagramme reçu. Cette option permet au champ d’en-tête IPv6 de la classe de trafic du datagramme reçu d’être retourné dans la structure WSAMSG . Le type de message retourné sera IPV6_TCLASS. Tous les bits DSCP et ECN du champ Traffic Class seront retournés. Cette option est valide uniquement sur les sockets de datagramme (le type de socket doit être SOCK_DGRAM). |
| IPV6_UNICAST_HOPS | Oui | Oui | DWORD | Obtient ou définit la valeur de durée de vie actuelle associée au socket IPv6 pour le trafic en monodiffusion. Il est illégal de définir la durée de vie sur une valeur supérieure à 255. |
| IPV6_UNICAST_IF | Oui | Oui | DWORD (IF_INDEX) | Obtient ou définit l’interface sortante pour l’envoi du trafic IPv6. Cette option ne modifie pas l’interface par défaut pour la réception du trafic IPv6. Cette option est importante pour les ordinateurs à plusieurs hébergements. La valeur d’entrée pour la définition de cette option est un index d’interface de 4 octets de l’interface sortante souhaitée dans l’ordre d’octet de l’hôte. La fonction GetAdaptersAddresses peut être utilisée pour obtenir les informations d’index d’interface. Si optval est égal à zéro, l’interface par défaut pour l’envoi du trafic IPv6 est définie sur non spécifié. Lors de l’obtention de cette option, optval retourne l’index d’interface par défaut actuel pour l’envoi du trafic IPv6 dans l’ordre d’octet de l’hôte. |
| IPV6_USER_MTU | Oui | Oui | DWORD | Obtient ou définit une limite supérieure sur la MTU de la couche IP (en octets) pour le socket donné. Si la valeur est supérieure à l’estimation par le système de la MTU du chemin d’accès (que vous pouvez récupérer sur un socket connecté en interrogeant l’option de socket IPV6_MTU ), l’option n’a aucun effet. Si la valeur est inférieure, les paquets sortants supérieurs à celle-ci sont fragmentés ou ne peuvent pas être envoyés, en fonction de la valeur de IPV6_DONTFRAG. La valeur par défaut est IP_UNSPECIFIED_USER_MTU (MAXULONG). Pour la sécurité du type, vous devez utiliser les fonctions WSAGetIPUserMtu et WSASetIPUserMtu au lieu d’utiliser directement l’option socket. |
| IPV6_V6ONLY | Oui | Oui | DWORD (booléen) | Indique si un socket créé pour la famille d'adresses AF_INET6 est limité uniquement aux communications IPv6. Les sockets créés pour la famille d'adresses AF_INET6 peuvent être utilisés pour les communications IPv6 et IPv4. Certaines applications peuvent restreindre leur utilisation d'un socket créé pour la famille d'adresses AF_INET6 aux seules communications IPv6. Lorsque cette valeur est différente de zéro (valeur par défaut sur Windows), un socket créé pour la famille d’adresses AF_INET6 peut être utilisé pour envoyer et recevoir des paquets IPv6 uniquement. Quand cette valeur est nulle, un socket créé pour la famille d'adresses AF_INET6 peut être utilisé pour envoyer et recevoir des paquets vers et depuis une adresse IPv6 ou IPv4. Notez que pour interagir avec une adresse IPv4, l'utilisation d'adresses IPv4 mappées est requise. Cette option de socket est prise en charge sous Windows Vista ou versions ultérieures. |
Prise en charge de Windows pour les options de socket IPPROTO_IPV6
| Option | Windows 8 | Windows Server 2012 | Windows 7 | Windows Server 2008 | Windows Vista |
|---|---|---|---|---|---|
| IP_ORIGINAL_ARRIVAL_IF | x | x | x | ||
| IPV6_ADD_IFLIST | À partir de Windows 10, version 1803 | ||||
| IPV6_ADD_MEMBERSHIP | x | x | x | x | x |
| IPV6_DEL_IFLIST | À partir de Windows 10, version 1803 | ||||
| IPV6_DROP_MEMBERSHIP | x | x | x | x | x |
| IPV6_GET_IFLIST | À partir de Windows 10, version 1803 | ||||
| IPV6_HDRINCL | x | x | x | x | x |
| IPV6_HOPLIMIT | x | x | x | x | x |
| IPV6_IFLIST | À partir de Windows 10, version 1803 | ||||
| IPV6_JOIN_GROUP | x | x | x | x | x |
| IPV6_LEAVE_GROUP | x | x | x | x | x |
| IPV6_MULTICAST_HOPS | x | x | x | x | x |
| IPV6_MULTICAST_IF | x | x | x | x | x |
| IPV6_MULTICAST_LOOP | x | x | x | x | x |
| IPV6_PKTINFO | x | x | x | x | x |
| IPV6_PROTECTION_LEVEL | x | x | x | x | x |
| IPV6_RECVIF | x | x | x | x | x |
| IPV6_UNICAST_HOPS | x | x | x | x | x |
| IPV6_UNICAST_IF | x | x | x | x | x |
| IPV6_V6ONLY | x | x | x | x | x |
| Option | Windows Server 2003 | Windows XP |
|---|---|---|
| IP_ORIGINAL_ARRIVAL_IF | ||
| IPV6_ADD_IFLIST | ||
| IPV6_ADD_MEMBERSHIP | x | x |
| IPV6_DEL_IFLIST | ||
| IPV6_DROP_MEMBERSHIP | x | x |
| IPV6_GET_IFLIST | ||
| IPV6_HDRINCL x | x | |
| IPV6_HOPLIMIT x | x | |
| IPV6_IFLIST | ||
| IPV6_JOIN_GROUP | x | x |
| IPV6_LEAVE_GROUP | x | x |
| IPV6_MULTICAST_HOPS | x | x |
| IPV6_MULTICAST_IF | x | x |
| IPV6_MULTICAST_LOOP | x | x |
| IPV6_PKTINFO | x | x |
| IPV6_PROTECTION_LEVEL | x | x |
| IPV6_RECVIF | ||
| IPV6_UNICAST_HOPS | x | x |
| IPV6_UNICAST_IF | ||
| IPV6_V6ONLY |
Notes
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 IPPROTO_IPV6 niveau est défini dans le fichier d’en-tête Ws2def.h qui est automatiquement inclus dans le fichier d’en-tête Winsock2.h. Les options de socket IPPROTO_IPV6 sont définies dans le fichier d’en-tête Ws2ipdef.h qui est automatiquement inclus dans le fichier d’en-tête Ws2tcpip.h . Les fichiers d’en-tête Ws2def.h et Ws2ipdef.h ne doivent jamais être utilisés directement.
L’option de socket IP_ORIGINAL_ARRIVAL_IF est prise en charge sur Windows Server 2008 R2 ainsi que sur Windows 7.
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|
Commentaires
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, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour