SocketOptionName Énumération

Définition

Définit les noms des options de configuration.

public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName = 
Public Enum SocketOptionName
Héritage
SocketOptionName

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.

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, comme les adresses avec le même préfixe local de lien ou de site. Cette option de socket permet aux applications de placer des restrictions d’accès sur des 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

Envoyez 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 send operations will time-out 
// if confirmation is not received within 1000 milliseconds.
s->SetSocketOption( SocketOptionLevel::Socket, SocketOptionName::SendTimeout, 1000 );

// 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 );
// Send operations will time-out if confirmation
// is not received within 1000 milliseconds.
s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000);

// The socket will linger for 10 seconds after Socket.Close is called.
LingerOption lingerOption = new LingerOption (true, 10);

s.SetSocketOption (SocketOptionLevel.Socket, SocketOptionName.Linger, lingerOption);
'Send operations will time-out if confirmation is 
' not received within 1000 milliseconds.
s.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.SendTimeout, 1000)

' 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