Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htHoldReadRecord - Захватить запись таблицы и считать ее тело

Назначение:

Функция позволяет захватить запись, заданную физическим номером и считать ее содержимое в буфер. Удобна как часть операции модификации записи (захват-чтение, изменение, освобождение).

Прототип:

 int HTAPI htHoldReadRecord(
	THANDLE		hTable,		/* Обработчик таблицы */
	long		gRecNo,		/* Номер захватываемой записи */
	void far 	*fpRecord	/* Для приема тела записи */
 );

Параметры

hTable
задает обработчик открытой таблицы, запись которой будет захвачена. Таблица должна быть открыта в совместном режиме, иначе запись будет считана без захвата
gRecNo
задает физический номер записи, подлежащей захвату
fpRecord
задает адрес буфера для чтения записи. Запись будет считана в указанный буфер целиком без физического номера

Результат:

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

Пример.

Захватить запись под номером 100 и считать ее содержимое.

typedef struct tagSTAFF { /* Структура записи таблицы работников */
	char name[15];
	unsigned fee;
} STAFF;
int rc;
STAFF rec;
THANDLE hTab;
rc = htTableOpen( "TABLE", NULL, NULL, TAB_SHARE, &hTab );
if( rc < 0 )
	/* Обработка ошибок */
 . . .
rc = htHoldReadRecord( hTab, 100L, &rec );
if( rc < 0 )
	/* Обработка ошибок */
 . . .
htReleaseRecord( hTab, 100L );
 . . .