Функция SQLTABLES( )

Сохраняет в курсоре Visual FoxPro имена таблиц источника данных.

Синтаксис

SQLTABLES(nConnectionHandle [, cTableTypes] [, cCursorName])

Параметры

nConnectionHandle

Задает дескриптор соединения с источником данных, возвращенный функцией SQLCONNECT( ).

cTableTypes

Задает тип таблиц. Допустимыми типами таблиц являются 'TABLE', 'VIEW', 'SYSTEM TABLE' или любой идентификатор типа таблицы, допустимый в данном источнике дан ых. Названия типов необходимо давать прописными буквами. Задавая список типов таблиц, разделяйте их запятыми.

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

Задаваемый тип таблицы должен быть заключен в апострофы. Ниже приводится приме , как можно задать типы таблиц 'VIEW' и 'SYSTEM TABLE' в виде строкового лите ала.

? SQLTABLES(handle, "'VIEW', 'SYSTEM TABLE'", "mydbresult")

cCursorName

Задает имя курсора Visual FoxPro, в который будет послано результирующее м ожество. Если имя курсора не указано, Visual FoxPro по умолчанию принимает имя SQLRESULT.

В следующей таблице описаны столбцы курсора.

Имя столбца	Описание
TABLE_QUALIFIER	Идентификатор описателя таблицы
TABLE_OWNER	Идентификатор владельца таблицы
TABLE_NAME	Имя таблицы, фигурирующее в словаре данных
TABLE_TYPE	Тип таблицы, фигурирующий в словаре данных
REMARKS	Описание таблицы

Результат

Числовой

Комментарии

Функция SQLTABLES( ) возвращает 1 при успешном создании курсора, 0, если SQLTABLES( ) продолжает выполняться, 1 при ошибке уровня соединения и 2 при ошибке уровня среды выполнения.

SQLTABLES( ) является одной из четырех функций, которые можно выполнять синхро но либо асинхронно. Конкретный режим работы определяется значением свойства Asynchronous, устанавливаемым функцией SQLSETPROP( ). В асинхронном режиме прихо ится повторно вызывать функцию SQLTABLES( ), пока не будет возвращено значение, отличное от 0, что соответствует продолжению выполнения.