Сканкод · дистрибьютор в РФ и СНГБаза знаний / Справочник TiOS / Разработка (TiOS) / Справочник по программированию / Объекты / Объект sock. / Свойства, методы и события
.tlsgetdata - метод
| Назначение: | Для текущего выбранного сокета (выбор выполняется через sock.num) возвращает строку с расшифрованными данными, извлечёнными из буфера приёма (RX) TLS. |
| Синтаксис: | sock.tlsgetdata(maxinplen as word) as string |
| Возвращает: | Строку с расшифрованными данными, извлечёнными из буфера приёма (RX) TLS. |
| См. также: | Transport Layer Security (TLS), Отправка и приём данных, sock.getdata |
| Параметр | Описание |
| maxinplen | Максимальное число байт расшифрованных данных, которое нужно вернуть (word). |
Подробности
Извлечённые данные безвозвратно удаляются из буфера. Длину извлекаемых данных ограничивает наименьшая из трёх величин: объём данных в буфере приёма (RX) TLS (см. sock.tlsrxlen), ёмкость «принимающей» строковой переменной и предел, заданный параметром maxinplen. Если вызвать этот метод для сокета, который не работает в режиме TLS (sock.tlscurrentnum <> sock.num), он вернёт пустую строку.
Внимание
В режиме TLS метод sock.getdata использовать нельзя: попытка извлечь данные из буфера приёма (RX) с большой вероятностью приведёт к разрыву защищённого соединения.