Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htHoldFreeRecords - Определить свободные от захвата записи и захватить их

Назначение:

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

Прототип:

LPSAB HTAPI htHoldFreeRecords(
	THANDLE	hTable, /* Обработчик таблицы */
	LPSAB	fpDst	/* БДС для списка свободных от захвата записей */
);

Параметры

hTable
задает обработчик открытой таблицы, записи которой будут захвачены. Таблица должна быть открыта в совместном режиме, иначе операция бесполезна
fpDst
задает адрес БДС, предназначенного для хранения списка захваченных записей

Результат:

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

Пример.

Захватить все свободные от захвата записи.

int rc;
SAB sab;
THANDLE hTab;
rc = htTableOpen( "TABLE", NULL, NULL, TAB_SHARE, &hTab );
if( rc < 0 )
	 /* Обработка ошибок */
 . . .
rc = htHoldFreeRecords( hTab, &sab );
if( rc < 0 )
	 /* Обработка ошибок */
else /* Захвачено sab.gFoundCnt записей */
	 . . .
htReleaseResults( &sab );
 . . .