Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htDupTableHandle - Дублировать обработчик таблицы

Назначение:

Иногда бывает необходимо получить доступ к одной и той же таблице два или более раз. Операция открытия, однако, не может быть выполнена дважды. Для получения второго или последующего обработчика таблицы можно воспользоваться функцией дублирования. Функция дублирует обработчик открытой ранее таблицы. Дублированный обработчик служит "алиасом" и имеет те же параметры (флаги доступа, пароли и пр.), что и основной.

Дубли обработчиков могут использоваться в любых операциях поиска и доступа наравне с "оригинальным" обработчиком.

Закрытие доступа к таблице может выполняться по любым обработчикам в любой последовательности. Реальное закрытие таблицы будет выполнено при закрытии последнего обработчика для данной таблицы.

Прототип:

int HTAPI htDupTableHandle(
  THANDLE  	hTable,	/* Исходный обработчик */
  LPTHANDLE	fpTable	/* Дубль обработчика */
 );

Параметры:

hTable
задает обработчик, подлежащий дублированию
fpTable
содержит адрес переменной для занесения дубля обработчика

Результат:

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

Пример.

Открыть доступ к таблице второй раз.

THANDLE		hView1;
THANDLE		hView2;
int		rc;
rc = htTableOpen( "table", NULL, NULL, TAB_PRIVATE, &hView1 );
if( rc < 0 )
	/* Обработка ошибок */
rc = htDupTableHandle( hView1, &hView2 );
if( rc < 0 )
	/* Обработка ошибок */