Получить значение поля выборки

Синтаксис

 
L_SWORD GetCellData (
  L_LONG lRow,              /* номер записи */
  L_LONG lColumn,           /* номер столбца */
  L_LONG lType,             /* тип данных */
  void *Data,               /* значение данных */
  L_LONG *plDataLen,        /* длина значения */
  L_LONG *plFlags);         /* флаги */

Входные параметры

Параметр Описание
lRow Порядковый номер записи в выборке, в которой находится нужное поле (отсчет начинается с 1)
lColumn Порядковый номер столбца в выборке, в котором находится нужное поле (нумерация начинается с 1)
lType Тип данных, в котором требуется вернуть значение поля выборки
Data Буфер для возвращаемого значения поля
plDataLen Длина буфера
plFlags Поле для возвращаемых атрибутов

Выходные параметры

Параметр Описание
Data Буфер со значением поля выборки
plDataLen Реальная длина значения поля выборки
plFlags Флаги, содержащие атрибуты поля выборки

Описание

Метод предоставляет значение и атрибуты поля выборки.

Если переданный буфер не позволяет разместить в нем значение поля, то возможны следующие варианты:

  1. в поле plFlags будет выставлен флаг LDS_CD_SMALLBUFFER, а в поле plDataLen возвратится необходимый размер буфера;

  2. в буфер будет скопирована часть значения (это связано со спецификой функции ConvertType библиотеки INTLIB);

  3. помимо флага LDS_CD_SMALLBUFFER может быть возвращён индикатор NULL-значения LDS_CD_NULL, если поле содержит NULL-значение.