Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

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

Назначение:

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

Прототип:

int HTAPI htTableElementList(
  THANDLE	hTable,		/* Обработчик для таблицы */
  LPELEMENT	fpElement	/* Массив структур описаний элементов */
);

Параметры:

hTable задает обработчик открытой таблицы
fpElement задает адрес массива выделенного в пользовательской программе массива структур для приема описателей элементов. Размерность массива должна совпадать с числом элементов записи. Число элементов в записи можно узнать после вызова функции htTableInfo ();

Результат:

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

Пример.

Получить описание элементов таблицы (проверки кодов завершения функций опущены для простоты).

int		nElenCnt;
LPELEMENT	fpsElem;
TABLE		sInfo;
THANDLE		hTable;
 . . .
htTableInfo( hTable, &sInfo );
/* Число элементов в записи */
nElemCnt = sInfo.nFieldCnt + sInfo.nGroupCnt + sInfo.nSubstrCnt;
/* Память для чтения описателей */
fpsElem = malloc( nElemCnt * sizeof(ELEMENT) );
/* Считать описатели элементов записи */
htTableElementList( hTable, fpsElem );