SocketOptionName Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit les noms des options de configuration.
public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName =
Public Enum SocketOptionName
- Héritage
Champs
AcceptConnection | 2 | Le socket est à l'écoute. |
AddMembership | 12 | Ajouter une appartenance au groupe IP. |
AddSourceMembership | 15 | Se joindre à un groupe source. |
BlockSource | 17 | Bloquer les données d'une source. |
Broadcast | 32 | Autoriser l'envoi de messages diffusés sur le socket. |
BsdUrgent | 2 | Utiliser des données urgentes comme défini dans RFC-1222. Cette option ne peut être définie qu'à une seule reprise ; une fois définie, elle ne peut plus être désactivée. |
ChecksumCoverage | 20 | Définir ou obtenir une couverture de checksum UDP. |
Debug | 1 | Enregistrer les informations de débogage. |
DontFragment | 14 | Ne pas fragmenter les datagrammes IP. |
DontLinger | -129 | Fermer le socket correctement sans le maintenir. |
DontRoute | 16 | Ne pas acheminer ; envoyer directement le paquet aux adresses d'interfaces. |
DropMembership | 13 | Abandonner une appartenance au groupe IP. |
DropSourceMembership | 16 | Déplacer un groupe source. |
Error | 4103 | Obtient l’état d’erreur et l’efface. |
ExclusiveAddressUse | -5 | Permet à un socket d'être limité à un accès exclusif. |
Expedited | 2 | Utiliser des données expédiées comme défini dans RFC-1222. Cette option ne peut être définie qu'à une seule reprise ; une fois définie, elle ne peut plus être désactivée. |
FastOpen | 15 | |
HeaderIncluded | 2 | Indique que l'application fournit l'en-tête IP pour les datagrammes sortants. |
HopLimit | 21 | Spécifie le nombre maximal de tronçons de routeur pour un paquet IPv6 (Internet Protocol version 6). Semblable au paramètre TTL (Time to Live) du protocole IPv4 (Internet Protocol version 4). |
IPOptions | 1 | Spécifie les options IP à insérer dans les datagrammes sortants. |
IPProtectionLevel | 23 | Active la restriction d’un socket IPv6 à une étendue spécifiée, telle que les adresses avec le même lien local ou le même préfixe local de site. Cette option de socket permet aux applications de placer des restrictions d’accès sur les sockets IPv6. Ces restrictions permettent à une application qui s'exécute sur un réseau local privé de se renforcer facilement et efficacement contre les attaques externes. Cette option de socket élargit ou limite la portée d'un socket en écoute, permettant l'accès illimité des utilisateurs publics et privés le cas échéant ou restreignant éventuellement l'accès au même site. Cette option de socket utilise les niveaux de protection définis spécifiés dans l'énumération IPProtectionLevel. |
IpTimeToLive | 4 | Définir le champ de durée de vie de l'en-tête IP. |
IPv6Only | 27 | 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. Quand cette valeur n'est pas nulle (valeur par défaut sous Windows), un socket créé pour la famille d'adresses AF_INET6 peut uniquement être utilisé pour envoyer et recevoir des paquets IPv6. 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. |
KeepAlive | 8 | Utiliser des connexions persistantes. |
Linger | 128 | Attendre pendant la fermeture s'il existe des données non envoyées. |
MaxConnections | 2147483647 | Option non prise en charge ; lève SocketException si elle est utilisée. |
MulticastInterface | 9 | Définir l'interface pour les paquets multicast sortants. |
MulticastLoopback | 11 | Bouclage multicast IP. |
MulticastTimeToLive | 10 | Durée de vie multicast IP. |
NoChecksum | 1 | Envoyer des datagrammes UDP dont le checksum a la valeur zéro. |
NoDelay | 1 | Désactive l'algorithme Nagle pour la fusion des envois. |
OutOfBandInline | 256 | Reçoit les données hors bande dans le flux de données normal. |
PacketInformation | 19 | Retourner des informations sur les paquets reçus. |
ReceiveBuffer | 4098 | Spécifie la quantité totale d'espace de la mémoire tampon réservée aux réceptions par socket. Cette valeur n'est pas liée à la taille maximale du message ou à la taille d'une fenêtre TCP. |
ReceiveLowWater | 4100 | Spécifie la limite inférieure pour les opérations Receive. |
ReceiveTimeout | 4102 | Recevoir un délai d’attente. Cette option s’applique uniquement aux méthodes synchrones ; elle n’a aucun effet sur les méthodes asynchrones telles que la BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) méthode . |
ReuseAddress | 4 | Autorise la liaison du socket à une adresse déjà utilisée. |
ReuseUnicastPort | 12295 | Indique que le système doit différer l'allocation de ports éphémères pour les connexions sortantes. Cela équivaut à utiliser l'option de socket SO_REUSE_UNICASTPORT de Winsock2. |
SendBuffer | 4097 | Spécifie la quantité totale d'espace de la mémoire tampon réservée aux envois par socket. Cette valeur n'est pas liée à la taille maximale du message ou à la taille d'une fenêtre TCP. |
SendLowWater | 4099 | Spécifie la limite inférieure pour les opérations Send. |
SendTimeout | 4101 | Envoyer un délai d’attente. Cette option s’applique uniquement aux méthodes synchrones ; elle n’a aucun effet sur les méthodes asynchrones telles que la BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) méthode . |
TcpKeepAliveInterval | 17 | Nombre de secondes pendant lesquelles une connexion TCP attend une réponse KeepAlive avant d’envoyer une autre sonde KeepAlive. |
TcpKeepAliveRetryCount | 16 | Nombre de sondes KeepAlive TCP qui seront envoyées avant la fin de la connexion. |
TcpKeepAliveTime | 3 | Nombre de secondes pendant lesquelles une connexion TCP reste active/inactive avant que les sondes KeepAlive soient envoyées à distance. |
Type | 4104 | Obtient le type de socket. |
TypeOfService | 3 | Modifier le champ correspondant au type de service de l'en-tête IP. |
UnblockSource | 18 | Débloquer une source préalablement bloquée. |
UpdateAcceptContext | 28683 | Met à jour les propriétés d'un socket accepté en utilisant celles d'un socket existant. Cela équivaut à utiliser l'option de socket SO_UPDATE_ACCEPT_CONTEXT de Winsock 2 ; cette option n'est prise en charge que sur les sockets orientés connexion. |
UpdateConnectContext | 28688 | Met à jour les propriétés d'un socket connecté en utilisant celles d'un socket existant. Cela équivaut à utiliser l'option de socket SO_UPDATE_CONNECT_CONTEXT de Winsock 2 ; cette option n'est prise en charge que sur les sockets orientés connexion. |
UseLoopback | 64 | Ignorer le matériel dans la mesure du possible. |
Exemples
L’exemple de code suivant utilise cette énumération pour définir les options de socket.
// Specifies that the Socket will linger for 10 seconds after Close is called.
LingerOption^ lingerOption = gcnew LingerOption(true, 10);
s->SetSocketOption(SocketOptionLevel::Socket, SocketOptionName::Linger, lingerOption);
// The socket will linger for 10 seconds after Socket.Close is called.
var lingerOption = new LingerOption(true, 10);
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
' The socket will linger for 10 seconds after Socket.Close is called.
Dim lingerOption As New LingerOption(True, 10)
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption)
Remarques
L’énumération SocketOptionName définit le nom de chaque Socket option de configuration. Les sockets peuvent être configurés avec la Socket.SetSocketOption méthode .
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour