CAsyncSocket::SetSockOpt

BOOL SetSockOpt ( int nOptionName, const void * lpOptionValue, int nOptionLen, int nLevel = SOL_SOCKET );

Valor devuelto

Distinto de cero si la función es correcta; en caso contrario 0 y un código de error específico se pueden recuperar llamando GetLastError. Los errores siguientes se aplican a esta función miembro:

• WSA&NOTINITIALISEDnbsp;  Un éxito AfxSocketInit debe producirse antes de utilizar este API.
  
  
• WSAE&NETDOWNnbsp;  La aplicación de Windows Sockets detecta que el subsistema de red no.
  
  
• WSAEFAULT lpOptionValue no está en una parte válida del espacio de direcciones del proceso.
  
  
• WSAEI&NPROGRESSnbsp;  Está en curso una operación bloqueo de Windows Sockets.
  
  
• WSAEI&NVALnbsp;nLevel no es válida o no es válida la información en lpOptionValue.
  
  
• WSAE&NETRESETnbsp;  Conexión ha agotado cuando SO_KEEPALIVE se establece.
  
  
• WSAE&NOPROTOOPTnbsp;  La opción es desconocido o no admitido. En particular, SO_BROADCAST no es compatible con sockets de tipo SOCK_STREAM, SO_DONTLINGER, SO_KEEPALIVE, SO_LINGERy SO_OOBINLINE no son compatibles en los sockets de tipo SOCK_DGRAM.
  
  
• WSAE&NOTCONNnbsp;  Se restableció la conexión cuando se establece SO_KEEPALIVE.
  
  
• WSAE&NOTSOCKnbsp;  El descriptor no es un socket.

Parámetros

nOptionName

Para que el valor se va a establecer la opción de socket.

lpOptionValue

Un puntero a la memoria intermedia en la que se suministra el valor de la opción solicitada.

nOptionLen

El tamaño del búfer de lpOptionValue en bytes.

nLevel

El nivel en que está definida la opción; los niveles admitidos sólo son SOL_SOCKET y IPPROTO_TCP.

Observaciones

Llame a esta función miembro para definir una opción de socket. SetSockOpt establece el valor actual de una opción de socket asociado con un zócalo de cualquier tipo, en cualquier Estado. Aunque pueden existir opciones en múltiples niveles de protocolo, esta especificación define sólo las opciones que existen en el nivel superior "zócalo". Opciones afectan a las operaciones de socket, como si se reciben datos acelerados en la secuencia de datos normal, si los mensajes de difusión pueden enviarse en el zócalo etc.

Existen dos tipos de opciones de socket: opciones booleanas que activar o desactivar una característica o comportamiento y opciones que requieren un valor entero o estructura. Para activar una opción de tipo Boolean, lpOptionValue apunta a un entero distinto de cero. Para desactivar los puntos de lpOptionValue de opción en un número entero igual a cero. nOptionLen debe ser igual al sizeof(BOOL) de opciones booleanas. Para otras opciones, puntos de lpOptionValue al entero o estructura que contiene el valor deseado para la opción y nOptionLen es la longitud de la estructura o entero.

SO_LINGER controla la acción realizada cuando no enviados datos en cola en un socket y se llama a la función de Cerrar para cerrar el socket. Para obtener más información, consulte Consideraciones de programación de Windows Sockets en la documentación del SDK de Win32.

De forma predeterminada, un socket no puede estar enlazado (véase el enlace) a una dirección local que ya está en uso. En ocasiones, sin embargo, puede ser deseable "reutilizar" una dirección de esta manera. Dado que cada conexión se identifica mediante la combinación de direcciones locales y remotas, no hay ningún problema con tener dos zócalos vinculados a la misma dirección local como las direcciones remotas son diferentes.

Informar a la aplicación de Windows Sockets que una llamada de enlace en un socket no ser prohibida porque la dirección deseada ya está en uso por otro socket, la aplicación debe establecer la opción de socket SO_REUSEADDR para el socket antes de emitir la convocatoria de enlazar . Tenga en cuenta que la opción es interpretada únicamente en el momento de la convocatoria de enlazar : por lo tanto, es innecesario (pero inofensivos) establecer la opción en un socket que no es estar enlazado a una dirección existente y establecer o restablecer la opción tras el enlace llamada no tiene ningún efecto sobre este o cualquier otro socket.

Una aplicación puede solicitar que la aplicación de Windows Sockets permiten el uso de paquetes "keep-alive" en las conexiones de protocolo de Control de transmisión (TCP) activando la opción de socket SO_KEEPALIVE . (Para obtener información sobre los paquetes "keep-alive", consulte Consideraciones de programación de Windows Sockets en la documentación del SDK de Win32.) Una aplicación de Windows Sockets no necesita apoyar el uso de keepalive: si lo hace, la semántica precisa son específicas de la aplicación, pero deben ajustarse a la sección 4.2.3.6 del RFC 1122: "requisitos para Hosts de Internet: capas de comunicación." Si una conexión se interrumpe como consecuencia de "abiertas" el código de error WSAENETRESET se devuelve a las llamadas en curso en el zócalo, y las llamadas posteriores se producirá un error con WSAENOTCONN.

La opción TCP_NODELAY deshabilita el algoritmo de Nagle. El algoritmo de Nagle se utiliza para reducir el número de pequeños paquetes enviados por un host de almacenamiento en búfer sin acuse de recibo de envío datos hasta que se puede enviar un paquete completo. Sin embargo, para algunas aplicaciones de este algoritmo puede obstaculizar el rendimiento, y TCP_NODELAY puede utilizarse para desactivarlo. Escritores de aplicación no deben establecer TCP_NODELAY a menos que el impacto de hacer es tan deseada y bien entendida desde configuración de TCP_NODELAY puede tener un impacto negativo importante sobre el rendimiento de la red. TCP_NODELAY es el único apoya la opción de socket que utiliza nivel IPPROTO_TCP; todas las demás opciones utilizan nivel SOL_SOCKET.

Algunas implementaciones de Windows Sockets suministro salida información de depuración si la opción SO_DEBUG está definida por una aplicación.

Se admiten las siguientes opciones para SetSockOpt. El tipo identifica el tipo de datos dirigidas por lpOptionValue.

Opciones de distribución de Software de Berkeley (BSD) no admite SetSockOpt:

Introducción a CAsyncSocket |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CAsyncSocket::AsyncSelect, CAsyncSocket::Bind, CAsyncSocket::Create, CAsyncSocket::GetSockOpt, CAsyncSocket::IOCtl