SO_CONDITIONAL_ACCEPT opción de socket
La opción de socket SO_CONDITIONAL_ACCEPT está diseñada para permitir que una aplicación decida si aceptar o no una conexión entrante en un socket de escucha.
Valor de opción de socket
La constante que representa esta opción de socket es 0x3002.
Sintaxis
int setsockopt(
(SOCKET) s, // descriptor identifying a socket
(int) SOL_SOCKET, // level
(int) SO_CONDITIONAL_ACCEPT, // optname
(char *) optval, // input buffer,
(int) optlen, // size of input buffer
);
Parámetros
-
s [in]
-
Descriptor que identifica el socket.
-
level [in]
-
Nivel en el que se define la opción. Use SOL_SOCKET para esta operación.
-
optname [in]
-
Opción de socket para la que se va a establecer el valor. Use SO_CONDITIONAL_ACCEPT para esta operación.
-
optval [out]
-
Puntero al búfer que contiene el valor de la opción que se va a establecer. Este parámetro debe apuntar al búfer igual o mayor que el tamaño de un valor DWORD .
Este valor se trata como un valor booleano con 0 que se usa para indicar FALSE (deshabilitado) y un valor distinto de cero para indicar TRUE (habilitado).
-
optlen [in, out]
-
Puntero al tamaño, en bytes, del búfer optval . Este tamaño debe ser igual o mayor que el tamaño de un valor DWORD .
Valor devuelto
Si la operación se completa correctamente, setsockopt devuelve cero.
Si se produce un error en la operación, se devuelve un valor de SOCKET_ERROR y se puede recuperar un código de error específico llamando a WSAGetLastError.
| Código de error | Significado |
|---|---|
| Debe producirse una llamada de WSAStartup correcta antes de usar esta función. |
|
| Error en el subsistema de red. |
|
| Uno de los parámetros optval o optlen apunta a la memoria que no está en una parte válida del espacio de direcciones del usuario. Este error también se devuelve si el valor al que apunta el parámetro optlen es menor que el tamaño de un valor DWORD . |
|
| Una llamada de Bloqueo de Windows Sockets 1.1 está en curso o el proveedor de servicios sigue procesando una función de devolución de llamada. |
|
| El parámetro level es desconocido o no válido. Este error también se devuelve si el socket ya estaba en un estado de escucha. |
|
| La opción es desconocida o no admitida por la familia de protocolos indicada. |
|
| El descriptor no es un socket. |
Comentarios
La función setsockopt llamada con la opción de socket SO_CONDITIONAL_ACCEPT permite a una aplicación decidir si aceptar o no una conexión entrante en un socket de escucha. La opción de aceptación condicional para un socket está deshabilitada (establecida en FALSE) de forma predeterminada.
Cuando esta opción de socket está habilitada, la pila TCP no acepta automáticamente las conexiones. Espera a que la aplicación indique que acepta la conexión a través de la devolución de llamada de aceptación condicional registrada con la función WSAAccept . Una vez recibida una solicitud de conexión, Winsock invoca la devolución de llamada de aceptación condicional registrada por la aplicación. Solo cuando la devolución de llamada de aceptación condicional devuelve CF_ACCEPT winsock notificará al transporte para aceptar completamente la conexión.
Cuando la opción de socket SO_CONDITIONAL_ACCEPT está establecida en habilitada (establecida en TRUE), esto tiene varios efectos secundarios en el socket:
- Esto deshabilita las defensas integradas de protección contra ataques SYN de la pila TCP, ya que la aplicación ahora toma posesión de la aceptación de conexiones.
- Esto deshabilita eficazmente el trabajo pendiente de escucha, ya que las conexiones no se aceptan en nombre de un socket de escucha. Una conexión nunca se acepta completamente hasta que la aplicación acepta completamente el uso del mecanismo de CF_ACCEPT .
- Esto también significa que la aplicación se encarga siempre de estar en un estado para controlar fácilmente las devoluciones de llamada de aceptación para aceptar la conexión. Si la aplicación está ocupada realizando otro procesamiento, el lado cliente puede agotar el tiempo de espera antes de que la aplicación acepte realmente la conexión. Esto conduce a una experiencia de cliente deficiente.
Por lo general, la razón principal por la que las aplicaciones usan la aceptación condicional es inspeccionar la dirección IP de origen o el puerto usado por el cliente de conexión y, a continuación, decidir aceptar o rechazar la conexión. Sin embargo, es probable que las aplicaciones funcionen mejor si la opción SO_CONDITIONAL_ACCEPT no está habilitada y la aplicación permite que la pila TCP y el trabajo pendiente de escucha funcionen según lo previsto. Después, cuando la aplicación controla la conexión aceptada, si procede de una dirección de origen o puerto IP incorrecta, la aplicación puede cerrar el socket. El inconveniente de seguridad de este comportamiento es que ahora el cliente tiene la confirmación de que la aplicación está escuchando en una dirección IP y un puerto, ya que cerró forzadamente la conexión aceptada anteriormente. Sin embargo, los inconvenientes de habilitar SO_CONDITIONAL_ACCEPT generalmente superan esta limitación.
La función getockopt llamada con la opción de socket SO_CONDITIONAL_ACCEPT permite a una aplicación recuperar el estado actual de la opción de aceptación condicional, aunque esta característica no se usa normalmente. Si una aplicación necesita habilitar la aceptación condicional en un socket, solo llama a la función setsockopt para habilitar la opción.
Tenga en cuenta que el archivo de encabezado Ws2def.h se incluye automáticamente en Winsock2.h y nunca se debe usar directamente.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado |
|
Consulte también