Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

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

htTableRename -Переименовать таблицу

Назначение:

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

Прототип:

int HTAPI htTableRename(
  char far	*fpTableName,	/* Имя таблицы (можно без расширения) */
  char far	*fpReadPswd,	/* Пароль доступа на чтение */
  char far	*fpWritePswd,	/* Пароль доступа на запись */
  char far	*fpNewName	/* Новое имя таблицы (можно в другом каталоге) */
);

Параметры:

fpTableName задает имя (полное или частичное) таблицы. Имя можно задавать без расширения.
fpReadPswd задает пароль доступа на чтение. Если не нужен, можно задать NULL или пустую строку "".
fpWritePswd задает пароль доступа на запись. Если не нужен, можно задать NULL или пустую строку "".
fpNewName задает имя таблицы, код которым будет сохранена копия исходной таблицы. Это имя может указывать другой каталог, но в пределах исходного диска.

Результат:

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

Пример.

Переименовать таблицу с переносом в другой каталог.

int	rc;
rc = htTableRename( "c:\\origin\\old", "read", "write", "c:\\new\\new" );
if( rc < 0 )
	/* Обработка ошибок */