Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция htTableElement

htTableElement - Получить описание элемента открытой таблицы

Назначение:

Функция служит для получения описания заданного элемента записи открытой таблицы (поля, группы или подстроки). Для получения характеристик большого числа полей предпочтительнее применять функцию htTableElementList (), которая считывает имена элементов из файла описания за один раз.

Прототип:

int HTAPI htTableElement(
  THANDLE	hTable, 	/* Обработчик для таблицы */
  int		nElemNo, 	/* Номер элемента таблицы (от 1) */
  LPELEMENT	fpElement, 	/* Структура для описания элемента */
  int		nReadName	/* !=0 читать имя элемента из файла */
);

Параметры:

hTable задает обработчик открытой таблицы
nElemNo задает номер элемента записи, описание которого нужно получить. Элементы записи нумеруются с 1 и включают в себя поля, группы и подстроки
fpElement задает адрес выделенной пользователем структуры для приема характеристик элемента. Структура имеет тип ELEMENT
nReadName задает флаг чтения имени элемента. Имя элемента будет считано, если задан флаг чтения, иначе оно будет заполнено символами \0. Если флаг чтения имени элемента не задан, функция извлекает описание элемента из внутренних переменных. При задании флага чтения имени функция считывает имя элемента из файла, что требует дополнительных временных затрат

Результат:

0 при успешном завершении
отрицательное число код ошибки

Пример.

Получить описание второго элемента таблицы, имя элемента не интересует.

ELEMENT sElem;
THANDLE hTable;
 . . .
htTableElement( hTable, 2, &sElem, 0 );