SocketTlsHandshake

Inicia una conexión TLS (SSL) protegida con el host indicado según el protocolo TLS Handshake. Durante el Handshake, el cliente y el servidor coordinan los parámetros de conexión: la versión del protocolo utilizado y el método de cifrado de los datos.

bool  SocketTlsHandshake(
   int           socket,               // socket
   const string  host                  // dirección del host
   );

Parámetros

socket

[in]  Manejador del socket retornado por la función SocketCreate. Al transmitir un manejador incorrecto, en _LastError se registra el error 5270 (ERR_NETSOCKET_INVALIDHANDLE).

host

[in]  Dirección del host con el que se establece la conexión protegida.

Valor retornado

Retorna true en caso de éxito, de lo contrario, false.

Observaciones

Antes de la conexión protegida, el programa deberá establecer una conexión TCP normal con el host con la ayuda de SocketConnect.

Si se da un error al establecer la conexión protegida, en _LastError se registrará el error 5274 (ERR_NETSOCKET_HANDSHAKE_FAILED).

La llamada de esta función no será necesaria si la conexión se realiza con el puerto 443. Se trata del puerto TCP estándar utilizado para las conexiones TLS (SSL) protegidas.

Solo se puede llamar la función desde los expertos y scripts, puesto que funcionan en su propio flujo de ejecución. Si se llama desde el indicador, GetLastError() retornará el error 4014 — "La función de sistema no está permitida para la llamada".