База знаний / Справочник TiOS / Разработка (TiOS) / Справочник по программированию / Объекты / Объект sock. / Свойства, методы и события

.tlsinit - метод

Назначение:	Для текущего выбранного сокета (выбор выполняется через sock.num) инициализирует все ресурсы, необходимые для установки TLS-соединения.
Синтаксис:	sock.tlsinit(offset as dword) as enum
Возвращает:	0 - PL_TLS_SUCCESS - инициализация выполнена успешно 1 - PL_TLS_REJECTED - попытка инициализации отклонена 2 - PL_TLS_ERROR_IN_USE - TLS уже используется на другом сокете 3 - PL_TLS_ERROR_CERT - ошибка сертификата 4 - PL_TLS_ERROR_NO_BUFF - недостаточно памяти 5 - PL_TLS_ERROR_INTERNAL - внутренняя ошибка без уточнения причины
См. также:	Transport Layer Security (TLS), Установка защищённого соединения, Получение сертификата шифрования

Параметр	Описание
offset	Смещение файла сертификата, включённого в скомпилированный двоичный файл проекта. Смещение получают с помощью свойства romfile.offset (только чтение).

Подробности

Этот метод инициализирует центр сертификации (CA) на основе сертификата, включённого в проект как файл ресурсов, и контекст TLS для выбранного сокета. Если в качестве offset передать 0, sock.tlsinit пропустит проверку сертификата.

Если sock.tlsinit вызвать после того, как TLS уже инициализирован на текущем сокете (sock.tlscurrentnum = sock.num), метод вернёт PL_TLS_REJECTED. Если вызвать его после инициализации TLS на другом сокете (sock.num <> sock.tlscurrentnum), он вернёт PL_TLS_ERROR_IN_USE.

PL_TLS_ERROR_CERT возвращается, если сертификат не удаётся разобрать: он не в формате X.509 или использует неподдерживаемый набор шифров.

На TPP2(G2), TPP3(G2), EM2000 и EM2001 PL_TLS_ERROR_NO_BUFF возвращается, если код не выделил нужное число страниц буфера методом sock.tlsbuffrq.

Внимание

Если вы увидите ошибку PL_TLS_ERROR_INTERNAL, обратитесь в службу поддержки Tibbo.

Исходный материал Tibbo обновлён 12 августа 2022Оригинал на docs.tibbo.com · Сообщить об ошибке