SocketOptionName Enumeración

Definición

Define los nombres de las opciones de configuración.Defines configuration option names.

public enum class SocketOptionName
public enum SocketOptionName
type SocketOptionName = 
Public Enum SocketOptionName
Herencia
SocketOptionName

Campos

AcceptConnection 2

El socket se encuentra a la escucha.The socket is listening.

AddMembership 12

Agrega la pertenencia a un grupo IP.Add an IP group membership.

AddSourceMembership 15

Une un grupo de origen.Join a source group.

BlockSource 17

Bloquea los datos de un origen.Block data from a source.

Broadcast 32

Permite el envío de mensajes de difusión en el socket.Permit sending broadcast messages on the socket.

BsdUrgent 2

Usa datos urgentes según la definición de RFC-1222.Use urgent data as defined in RFC-1222. Esta opción solo se puede establecer una vez; una vez establecida, no se puede desactivar.This option can be set only once; after it is set, it cannot be turned off.

ChecksumCoverage 20

Obtiene o establece la activación de la suma de comprobación UDP.Set or get the UDP checksum coverage.

Debug 1

Registra información de depuración.Record debugging information.

DontFragment 14

No fragmenta los datagramas IP.Do not fragment IP datagrams.

DontLinger -129

Cierra rápidamente el socket, sin demorarse.Close the socket gracefully without lingering.

DontRoute 16

No realiza ningún tipo de enrutamiento; envía directamente el paquete a las direcciones de interfaz.Do not route; send the packet directly to the interface addresses.

DropMembership 13

Quita la pertenencia a un grupo IP.Drop an IP group membership.

DropSourceMembership 16

Coloca un grupo de origen.Drop a source group.

Error 4103

Obtiene el estado de error y borra.Gets the error status and clear.

ExclusiveAddressUse -5

Permite enlazar un socket para obtener acceso exclusivo.Enables a socket to be bound for exclusive access.

Expedited 2

Usa datos inmediatos según la definición de RFC-1222.Use expedited data as defined in RFC-1222. Esta opción solo se puede establecer una vez; una vez establecida, no se puede desactivar.This option can be set only once; after it is set, it cannot be turned off.

HeaderIncluded 2

Indica que la aplicación proporciona el encabezado IP para los datagramas de salida.Indicates that the application provides the IP header for outgoing datagrams.

HopLimit 21

Especifica el número máximo de saltos del enrutador para un paquete IPv6 (Protocolo de Internet versión 6).Specifies the maximum number of router hops for an Internet Protocol version 6 (IPv6) packet. Esto último es similar al período de vida (TTL) del Protocolo de Internet versión 4.This is similar to Time to Live (TTL) for Internet Protocol version 4.

IPOptions 1

Especifica las opciones IP que se van a insertar en los datagramas de salida.Specifies the IP options to be inserted into outgoing datagrams.

IPProtectionLevel 23

Habilita la restricción de un socket IPv6 a un ámbito especificado, como direcciones con el mismo prefijo local de vínculo o sitio. Esta opción de socket permite a las aplicaciones colocar restricciones de acceso en 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. Estas restricciones permiten que una aplicación que se ejecuta en una LAN privada se fortalezca de forma sencilla frente a ataques externos.Such restrictions enable an application running on a private LAN to simply and robustly harden itself against external attacks. Esta opción de socket amplía o reduce el ámbito de un socket de escucha, lo que permite el acceso no restringido de usuarios públicos y privados cuando sea adecuado o restringe el acceso únicamente al mismo sitio, según necesidad.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. Esta opción de socket definió niveles de protección especificados en la enumeración IPProtectionLevel.This socket option has defined protection levels specified in the IPProtectionLevel enumeration.

IpTimeToLive 4

Establece el campo correspondiente al período de vida del encabezado IP.Set the IP header Time-to-Live field.

IPv6Only 27

Indica si un socket creado para la familia de direcciones AF_INET6 sólo está restringido a las comunicaciones IPv6.Indicates if a socket created for the AF_INET6 address family is restricted to IPv6 communications only. Los sockets creados para la familia de direcciones AF_INET6 se pueden usar para comunicaciones IPv6 e IPv4.Sockets created for the AF_INET6 address family may be used for both IPv6 and IPv4 communications. Es posible que algunas aplicaciones deseen restringir su uso de un socket creado para la familia de direcciones AF_INET6 a comunicaciones IPv6 únicamente.Some applications may want to restrict their use of a socket created for the AF_INET6 address family to IPv6 communications only. Cuando este valor es distinto de cero (el valor predeterminado en Windows), un socket creado para la familia de direcciones AF_INET6 se puede usar para enviar y recibir paquetes IPv6 únicamente.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. Cuando este valor es cero, un socket creado para la familia de direcciones AF_INET6 se puede usar para enviar y recibir paquetes a y desde una dirección IPv6 o una dirección 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. Tenga en cuenta que la capacidad de interactuar con una dirección IPv4 exige el uso de direcciones asignadas IPv4.Note that the ability to interact with an IPv4 address requires the use of IPv4 mapped addresses. Esta opción de socket es compatible con Windows Vista o posterior.This socket option is supported on Windows Vista or later.

KeepAlive 8

Usa encabezados de mantenimiento de conexión.Use keep-alives.

Linger 128

Se demora el cierre si existen datos no enviados.Linger on close if unsent data is present.

MaxConnections 2147483647

No se admite; en caso de que se use, se producirá una excepción SocketException.Not supported; will throw a SocketException if used.

MulticastInterface 9

Establece la interfaz para los paquetes de multidifusión salientes.Set the interface for outgoing multicast packets.

MulticastLoopback 11

Retorno de bucle de multidifusión IP.An IP multicast loopback.

MulticastTimeToLive 10

Período de vida de multidifusión IP.An IP multicast Time to Live.

NoChecksum 1

Envía datagramas UDP con la suma de comprobación establecida en cero.Send UDP datagrams with checksum set to zero.

NoDelay 1

Deshabilita el algoritmo de Nagle para la fusión de envíos.Disables the Nagle algorithm for send coalescing.

OutOfBandInline 256

Recibe los datos fuera de banda en el flujo normal de datos.Receives out-of-band data in the normal data stream.

PacketInformation 19

Devuelve información sobre los paquetes recibidos.Return information about received packets.

ReceiveBuffer 4098

Especifica el espacio total de búfer por socket reservado para las recepciones.Specifies the total per-socket buffer space reserved for receives. Este espacio no está relacionado con el tamaño máximo de los mensajes o el tamaño de una ventana TCP.This is unrelated to the maximum message size or the size of a TCP window.

ReceiveLowWater 4100

Especifica la marca de agua suave para las operaciones Receive.Specifies the low water mark for Receive operations.

ReceiveTimeout 4102

Recibe un tiempo de espera. Esta opción sólo se aplica a los métodos sincrónicos; no tiene ningún efecto sobre los métodos asincrónicos, como el método 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 4

Permite enlazar el socket a una dirección que ya está en uso.Allows the socket to be bound to an address that is already in use.

ReuseUnicastPort 12295

Indica que el sistema debe aplazar la asignación de puertos efímeros para las conexiones salientes.Indicates that the system should defer ephemeral port allocation for outbound connections. Equivale a usar la opción de socket SO_REUSE_UNICASTPORT de Winsock2.This is equivalent to using the Winsock2 SO_REUSE_UNICASTPORT socket option.

SendBuffer 4097

Especifica el espacio total de búfer por socket reservado para los envíos.Specifies the total per-socket buffer space reserved for sends. Este espacio no está relacionado con el tamaño máximo de los mensajes o el tamaño de una ventana TCP.This is unrelated to the maximum message size or the size of a TCP window.

SendLowWater 4099

Especifica la marca de agua suave para las operaciones Send.Specifies the low water mark for Send operations.

SendTimeout 4101

Envía un tiempo de espera. Esta opción sólo se aplica a los métodos sincrónicos; no tiene ningún efecto sobre los métodos asincrónicos, como el método 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 17

El número de segundos que esperará una conexión TCP para obtener una respuesta persistente antes de enviar otro sondeo persistente.The number of seconds a TCP connection will wait for a keepalive response before sending another keepalive probe.

TcpKeepAliveRetryCount 16

Número de sondeos persistentes de TCP que se enviarán antes de que finalice la conexión.The number of TCP keep alive probes that will be sent before the connection is terminated.

TcpKeepAliveTime 3

Número de segundos durante los que una conexión TCP permanecerá activa o inactiva antes de que se envíen sondeos persistentes al repositorio remoto.The number of seconds a TCP connection will remain alive/idle before keepalive probes are sent to the remote.

Type 4104

Obtiene el tipo de socket.Gets the socket type.

TypeOfService 3

Cambia el tipo de encabezado IP del campo de servicios.Change the IP header type of the service field.

UnblockSource 18

Desbloquea un origen anteriormente bloqueado.Unblock a previously blocked source.

UpdateAcceptContext 28683

Actualiza las propiedades de un socket aceptado usando las propiedades de un socket existente.Updates an accepted socket's properties by using those of an existing socket. Esto último equivale a usar la opción de socket SO_UPDATE_ACCEPT_CONTEXT de Winsock2 y sólo se admite en sockets orientados a conexiones.This is equivalent to using the Winsock2 SO_UPDATE_ACCEPT_CONTEXT socket option and is supported only on connection-oriented sockets.

UpdateConnectContext 28688

Actualiza las propiedades de un socket conectado usando las propiedades de un socket existente.Updates a connected socket's properties by using those of an existing socket. Esto último equivale a usar la opción de socket SO_UPDATE_CONNECT_CONTEXT de Winsock2 y sólo se admite en sockets orientados a conexiones.This is equivalent to using the Winsock2 SO_UPDATE_CONNECT_CONTEXT socket option and is supported only on connection-oriented sockets.

UseLoopback 64

Omite el hardware siempre que sea posible.Bypass hardware when possible.

Ejemplos

En el ejemplo de código siguiente se utiliza esta enumeración para establecer las opciones 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)

Comentarios

La SocketOptionName enumeración define el nombre de Socket cada opción de configuración.The SocketOptionName enumeration defines the name of each Socket configuration option. Los sockets se pueden configurar con Socket.SetSocketOption el método.Sockets can be configured with the Socket.SetSocketOption method.

Se aplica a

Consulte también: