SocketOptionName SocketOptionName SocketOptionName SocketOptionName Enum

Définition

Définit les noms des options de configuration.Defines configuration option names.

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

Champs

AcceptConnection AcceptConnection AcceptConnection AcceptConnection 2

Le socket est à l'écoute.The socket is listening.

AddMembership AddMembership AddMembership AddMembership 12

Ajouter une appartenance au groupe IP.Add an IP group membership.

AddSourceMembership AddSourceMembership AddSourceMembership AddSourceMembership 15

Se joindre à un groupe source.Join a source group.

BlockSource BlockSource BlockSource BlockSource 17

Bloquer les données d'une source.Block data from a source.

Broadcast Broadcast Broadcast Broadcast 32

Autoriser l'envoi de messages diffusés sur le socket.Permit sending broadcast messages on the socket.

BsdUrgent BsdUrgent BsdUrgent BsdUrgent 2

Utiliser des données urgentes comme défini dans RFC-1222.Use urgent data as defined in 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.This option can be set only once; after it is set, it cannot be turned off.

ChecksumCoverage ChecksumCoverage ChecksumCoverage ChecksumCoverage 20

Définir ou obtenir une couverture de checksum UDP.Set or get the UDP checksum coverage.

Debug Debug Debug Debug 1

Enregistrer les informations de débogage.Record debugging information.

DontFragment DontFragment DontFragment DontFragment 14

Ne pas fragmenter les datagrammes IP.Do not fragment IP datagrams.

DontLinger DontLinger DontLinger DontLinger -129

Fermer le socket correctement sans le maintenir.Close the socket gracefully without lingering.

DontRoute DontRoute DontRoute DontRoute 16

Ne pas acheminer ; envoyer directement le paquet aux adresses d'interfaces.Do not route; send the packet directly to the interface addresses.

DropMembership DropMembership DropMembership DropMembership 13

Abandonner une appartenance au groupe IP.Drop an IP group membership.

DropSourceMembership DropSourceMembership DropSourceMembership DropSourceMembership 16

Déplacer un groupe source.Drop a source group.

Error Error Error Error 4103

Obtient l’état d’erreur et l’efface.Gets the error status and clear.

ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse ExclusiveAddressUse -5

Permet à un socket d'être limité à un accès exclusif.Enables a socket to be bound for exclusive access.

Expedited Expedited Expedited Expedited 2

Utiliser des données expédiées comme défini dans RFC-1222.Use expedited data as defined in 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.This option can be set only once; after it is set, it cannot be turned off.

HeaderIncluded HeaderIncluded HeaderIncluded HeaderIncluded 2

Indique que l'application fournit l'en-tête IP pour les datagrammes sortants.Indicates that the application provides the IP header for outgoing datagrams.

HopLimit HopLimit HopLimit HopLimit 21

Spécifie le nombre maximal de tronçons de routeur pour un paquet IPv6 (Internet Protocol version 6).Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. Semblable au paramètre TTL (Time to Live) du protocole IPv4 (Internet Protocol version 4).This is similar to Time to Live (TTL) for Internet Protocol version 4.

IPOptions IPOptions IPOptions IPOptions 1

Spécifie les options IP à insérer dans les datagrammes sortants.Specifies the IP options to be inserted into outgoing datagrams.

IPProtectionLevel IPProtectionLevel IPProtectionLevel IPProtectionLevel 23

Active la restriction d'un socket IPv6 à une portée spécifiée, telle que les adresses avec le même préfixe de lien local ou de site local. Cette option de socket permet aux applications de placer des restrictions d'accès sur les sockets IPv6.Enables restriction of a IPv6 socket to a specified scope, such as addresses with the same link local or site local prefix.This socket option enables applications to place access restrictions on IPv6 sockets. 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.Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. 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.This socket option widens or narrows the scope of a listening socket, enabling unrestricted access from public and private users when appropriate, or restricting access only to the same site, as required. Cette option de socket utilise les niveaux de protection définis spécifiés dans l'énumération IPProtectionLevel.This socket option has defined protection levels specified in the IPProtectionLevel enumeration.

IpTimeToLive IpTimeToLive IpTimeToLive IpTimeToLive 4

Définir le champ de durée de vie de l'en-tête IP.Set the IP header Time-to-Live field.

IPv6Only IPv6Only IPv6Only IPv6Only 27

Indique si un socket créé pour la famille d'adresses AF_INET6 est limité uniquement aux communications IPv6.Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. Les sockets créés pour la famille d'adresses AF_INET6 peuvent être utilisés pour les communications IPv6 et IPv4.Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. Certaines applications peuvent restreindre leur utilisation d'un socket créé pour la famille d'adresses AF_INET6 aux seules communications IPv6.Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. 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.When this value is non-zero (the default on Windows), a socket created for the AF_INET6 address family can be used to send and receive IPv6 packets only. 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.When this value is zero, a socket created for the AF_INET6 address family can be used to send and receive packets to and from an IPv6 address or an IPv4 address. Notez que pour interagir avec une adresse IPv4, l'utilisation d'adresses IPv4 mappées est requise.Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. Cette option de socket est prise en charge sous Windows Vista ou versions ultérieures.This socket option is supported on Windows Vista or later.

KeepAlive KeepAlive KeepAlive KeepAlive 8

Utiliser des connexions persistantes.Use keep-alives.

Linger Linger Linger Linger 128

Attendre pendant la fermeture s'il existe des données non envoyées.Linger on close if unsent data is present.

MaxConnections MaxConnections MaxConnections MaxConnections 2147483647

Option non prise en charge ; lève SocketException si elle est utilisée.Not supported; will throw a SocketException if used.

MulticastInterface MulticastInterface MulticastInterface MulticastInterface 9

Définir l'interface pour les paquets multicast sortants.Set the interface for outgoing multicast packets.

MulticastLoopback MulticastLoopback MulticastLoopback MulticastLoopback 11

Bouclage multicast IP.An IP multicast loopback.

MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive MulticastTimeToLive 10

Durée de vie multicast IP.An IP multicast Time to Live.

NoChecksum NoChecksum NoChecksum NoChecksum 1

Envoyer des datagrammes UDP dont le checksum a la valeur zéro.Send UDP datagrams with checksum set to zero.

NoDelay NoDelay NoDelay NoDelay 1

Désactive l'algorithme Nagle pour la fusion des envois.Disables the Nagle algorithm for send coalescing.

OutOfBandInline OutOfBandInline OutOfBandInline OutOfBandInline 256

Reçoit les données hors bande dans le flux de données normal.Receives out-of-band data in the normal data stream.

PacketInformation PacketInformation PacketInformation PacketInformation 19

Retourner des informations sur les paquets reçus.Return information about received packets.

ReceiveBuffer ReceiveBuffer ReceiveBuffer ReceiveBuffer 4098

Spécifie la quantité totale d'espace de la mémoire tampon réservée aux réceptions par socket.Specifies the total per-socket buffer space reserved for receives. Cette valeur n'est pas liée à la taille maximale du message ou à la taille d'une fenêtre TCP.This is unrelated to the maximum message size or the size of a TCP window.

ReceiveLowWater ReceiveLowWater ReceiveLowWater ReceiveLowWater 4100

Spécifie la limite inférieure pour les opérations Receive.Specifies the low water mark for Receive operations.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout 4102

Recevoir le 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 méthode BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Receive a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

ReuseAddress ReuseAddress ReuseAddress ReuseAddress 4

Autorise la liaison du socket à une adresse déjà utilisée.Allows the socket to be bound to an address that is already in use.

ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort ReuseUnicastPort 12295

Indique que le système doit différer l'allocation de ports éphémères pour les connexions sortantes.Indicates that the system should defer ephemeral port allocation for outbound connections. Cela équivaut à utiliser l'option de socket SO_REUSE_UNICASTPORT de Winsock2.This is equivalent to using the Winsock2 SO_REUSE_UNICASTPORT socket option.

SendBuffer SendBuffer SendBuffer SendBuffer 4097

Spécifie la quantité totale d'espace de la mémoire tampon réservée aux envois par socket.Specifies the total per-socket buffer space reserved for sends. Cette valeur n'est pas liée à la taille maximale du message ou à la taille d'une fenêtre TCP.This is unrelated to the maximum message size or the size of a TCP window.

SendLowWater SendLowWater SendLowWater SendLowWater 4099

Spécifie la limite inférieure pour les opérations Send.Specifies the low water mark for Send operations.

SendTimeout SendTimeout SendTimeout 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 méthode BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object).Send a time-out. This option applies only to synchronous methods; it has no effect on asynchronous methods such as the BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) method.

TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval TcpKeepAliveInterval 17
TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount TcpKeepAliveRetryCount 16
TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime TcpKeepAliveTime 3
Type Type Type Type 4104

Obtient le type de socket.Gets the socket type.

TypeOfService TypeOfService TypeOfService TypeOfService 3

Modifier le champ correspondant au type de service de l'en-tête IP.Change the IP header type of the service field.

UnblockSource UnblockSource UnblockSource UnblockSource 18

Débloquer une source préalablement bloquée.Unblock a previously blocked source.

UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext UpdateAcceptContext 28683

Met à jour les propriétés d'un socket accepté en utilisant celles d'un socket existant.Updates an accepted socket's properties by using those of an existing socket. 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.This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets.

UpdateConnectContext UpdateConnectContext UpdateConnectContext UpdateConnectContext 28688

Met à jour les propriétés d'un socket connecté en utilisant celles d'un socket existant.Updates a connected socket's properties by using those of an existing socket. 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.This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets.

UseLoopback UseLoopback UseLoopback UseLoopback 64

Ignorer le matériel dans la mesure du possible.Bypass hardware when possible.

Exemples

L’exemple de code suivant utilise cette énumération pour définir les options de socket.The following code example uses this enumeration to set socket options.

// 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

Le SocketOptionName énumération définit le nom de chaque Socket option de configuration.The SocketOptionName enumeration defines the name of each Socket configuration option. Sockets peuvent être configurés avec la Socket.SetSocketOption (méthode).Sockets can be configured with the Socket.SetSocketOption method.

S’applique à

Voir aussi