Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htCreateEmptySAB - Создать пустой результат для одной таблицы

Назначение:

Функция предназначена для максимально быстрого создания пустого результата заданного типа для одной таблицы. Пустой результат можно было бы получить выполнив поиск с нулевыми условиями, но такой способ потребовал бы дополнительных временных затрат.

Прототип:

LPSAB HTAPI htCreateEmptySAB(
  LPSAB		fpPHO,		/* Снимок таблицы */
  LPSAB		fpSAB,		/* Адрес БДС */
  THANDLE		hTable,		/* Обработчик таблицы */
  int		nItemNo,	/* Номер элемента */
  int		nType		/* Тип БДС (см.RES_????) */
);

Параметры

fpPHO задает адрес БДС, содержащего "снимок" таблицы для поиска. Если не задан (NULL) будет взято текущее состояние
fpSAB содержит адрес БДС, предназначенного для приема пустых результатов.
hTable задает обработчик таблицы, для которой создается результат
nItemNo задает номер элемента записи, который будет занесен в результат, как если бы последний был получен для данного элемента записи. Нумерация элементов в записи сквозная, начинается с 1 и включает не только поля, но также группы и подстроки
nType определяет получаемый тип результата и должен содержать одну из констант RES_TYPE. Возможные значения результата для данной функции - RES_RECORD, RES_SORTED, RES_VALUE и RES_HISTO

Результат

адрес БДС, заданного в качестве второго параметра успех
NULL Ошибка (поле fpSAB->nRetCode будет содержать код ошибки).