SocketTlsHandshake

Инициирует защищенное TLS (SSL)-соединение с указанным хостом по протоколу TLS Handshake. Во время Handshake клиент и сервер согласовывают параметры соединения: версию используемого протокола и способ шифрования данных.

bool  SocketTlsHandshake(
   int           socket,               // сокет
   const string  host                  // адрес хоста
   );

Параметры

socket

[in]  Хэндл сокета, возвращаемый функцией SocketCreate. При передаче неверного хэндла в _LastError записывается ошибка 5270 (ERR_NETSOCKET_INVALIDHANDLE).

host

[in]  Адрес хоста, с которым устанавливается защищенное соединение.

Возвращаемое значение

Возвращает true в случае успеха, иначе false.

Примечания

До защищенного соединения программа должна установить обычное TCP-соединение с хостом при помощи SocketConnect.

При ошибке установления защищенного соединения в _LastError записывается ошибка 5274 (ERR_NETSOCKET_HANDSHAKE_FAILED).

Вызов этой функции не требуется, если подключение осуществляется к порту 443. Это стандартный TCP-порт, используемый для защищенных TLS (SSL)-подключений.

Функцию можно вызывать только из экспертов и скриптов, так как они работают в собственном потоке выполнения. При вызове из индикатора GetLastError() вернет ошибку 4014 – "Системная функция не разрешена для вызова".