Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htTableHandleByName - Обработчик таблицы по имени

Назначение:

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

Эту функцию можно использовать также для предотвращения ошибок, связанных с повторным открытием уже открытых таблиц.

Прототип:

int HTAPI htTableHandleByName(
  char far 	*fpTabName,	/* Имя таблицы (можно без расширения) */
  LPTHANDLE	fpHandle   	/* Для приема обработчика таблицы */
);

Параметры

fpTabName
задает имя файла описания таблицы (с указанием полного или частичного пути), расширение задавать не обязательно.
fpHandle
задает адрес переменной для занесения обработчика таблицы с заданным именем.

Результат:

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

Пример.

Открыть доступ к таблице (если еще не открыт) или дублировать обработчик (если таблица была открыта).

int OpenTable( char far* fpName, LPTHANDLE fphTable )
{
	THANDLE hTable;
	if( htTableHandleByName( fpName, &hTable ) < 0 )
		return htTableOpen( fpName, NULL, NULL, TAB_PRIVATE, fphTable );
	else
		return htDupTableHandle( hTable, fphTable );
}