Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htHandleAdd - Добавить запись в таблицу с получением обработчика

Назначение:

Функция аналогична htRecordAdd, но позволяет получить обработчик добавленной записи на момент выполнения операции. Функция позволяет добавить запись в таблицу. Добавление невозможно, если таблица открыта в режиме "только на чтение" или захвачена другими пользователями сети в монопольном режиме. Тело добавляемой записи содержит значения для всех полей записи в том виде, как они описаны. Каждая запись перед добавлением проверяется на допустимость значений, а также на уникальность первичных ключей. В случае удачного прохождения проверок запись добавляется в журнал изменений, а функция возвращает положительное число большее нуля - физический номер для записи.

Если в записи имеется суррогатный ключ, его значение будет занесено в тело записи после успешного завершения операции добавления.

Функция возвращает физический номер добавленной записи в случае нормального завершения

Прототип:

long HTAPI htHandleAdd(
  THANDLE 	hTable,		/* Обработчик для таблицы */
  void far 	*fpRecord, 	/* Тело записи */
  LPRHANDLE	fphRecord 	/* Обработчик добавленной записи */
);

Параметры

hTable
задает допустимый обработчик таблицы
fpRecord
задает тело добавляемой записи
fphRecord
задает адрес переменной для сохранения полученного обработчика записи

Результат

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