Функция SQLSETPROP( )

Задает установки для активного соединения.

Синтаксис

SQLSETPROP(nConnectionHandle, cSetting [, eExpression])

Параметры

nConnectionHandle

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

cSetting

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

Установка	Описание
Asynchronous	Задает режим возвращения результирующих множеств: синхронный (ложь (.F.), по умолчанию) или асинхронный (истина (.T.)). Чтение/запись.
BatchMode	Определяет возвращает ли SQLEXEC( ) множества результатов все одновремен о(истина (.T.) по умолчанию) или индивидуально с помощью функции SQLMORERESULTS( ) ( ожь (.F.)). Чтение/запись.
ConnectBusy	Содержит значение истина (.T.), если совместно используемое соединение занято, и ложь (.F.) в противном случае. Только чтение.
ConnectString	Регистрационная строка соединения. Только чтение.
ConnectTimeOut	Задает время ожидания (в секундах) для возвращения ошибки тайм-аута соедине ия. Если задать 0 (принимается по умолчанию), ожидание будет неопределенно долгим и ошибка тайм-аута возвращена не будет. Диапазон допустимых значений ConnTimeOut от 0 дo 600. Чтение/запись.
DataSource	Имя источника данных, определенное в файле ODBC.INI. Чтение/запись.
DispLogin	Содержит числовое значение, определяющее, когда будет отображаться диалоговое окно ODBC Login. DispLogin может принимать следующие значения: 1 или DB_COMPLETE (из файла FOXPRO.H). 1 принимается по умолчанию. 2 или DB_PROMPT (из FOXPRO.H). 3 или DB_NOPROMPT (из FOXPRO.H). Если задано значение 1 или DB_COMPLETE, Visual FoxPro отображает диалоговое ок о ODBC Login только в том случае, если не хватает какой-либо нужной информации. Если задано 2 или DB_PROMPT, диалоговое окно ODBC Login отображается всегда, авая возможность изменять установки перед формированием соединения. Если задано 3 или DB_NOPROMPT, диалоговое окно ODBC Login не отображается и Visual FoxPro при отсутствии требуемой регистрационной информации сгенерирует оши ку. Чтение/запись.
DispWarnings	Задает, будут отображаться сообщения об ошибках (истина (.T.)) или нет (ложь (.F.)). По умолчанию принимается 0 (сообщения об ошибках не отображаются). Чтение/запись.
IdleTimeout	Интервал тайм-аута при простое. По истечении указанного интервала активные сое инения деактивизируются. По умолчанию принимается значение 0 (неопределенно до гое ожидание). Чтение/запись.
ODBChdbc	Внутренний номер соединения ODBC, который может использоваться файлами внешних библиотек (файлами FLL) для вызова ODBC. Только чтение.
ODBChstmt	Внутренний номер оператора ODBC, который может использоваться файлами внешних иблиотек (файлами FLL) для вызова ODBC. Только чтение.
PacketSize	Размер пакета сети, используемый соединением. Настройка значения может пов сить производительность. Значение по умолчанию 4096 байтов (4K). Чтение/запись
Password	Пароль соединения. Только чтение.
QueryTimeOut	Задает время ожидания (в секундах) возвращения ошибки общего тайм-аута. Если задать 0, ожидание будет неопределенно долгим и ошибка тайм-аута возвращена не удет. Диапазон допустимых значений QueryTimeOut от 0 дo 600. По умолчанию при имается 15. Чтение/запись.
Transactions	Содержит числовое значение, определяющее, как соединение обрабатывает тра закции в удаленной таблице. Transactions может принимать следующие значения: 1 или DB_TRANSAUTO (из файла FOXPRO.H). 1 принимается по умолчанию. Обработка транзакций для удаленной таблицы выпол яется автоматически. 2 или DB_TRANSMANUAL (из FOXPRO.H). Обработка транзакций выполняется явно с помощью функций SQLCOMMIT( ) и SQLROLLBACK( ). Чтение/запись.
UserId	Идентификатор пользователя. Только чтение.
WaitTime	Период времени в миллисекундах, проходящий до того, как Visual FoxPro прове ит, закончил ли выполнение оператор SQL. По умолчанию принимается значение 100 ми лисекунд. Чтение/запись.

eExpression

Задает значение для установки, указанной аргументом cSetting. Если опустить eExpression, будет восстановлено значение, принимаемое по умолчанию.

Результат

Числовой

Комментарии

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

Пользуйтесь функцией SQLSETPROP( ) для задания установок на уровне соединения. Чтобы задать установки Visual FoxPro, принимаемые по умолчанию на уровне среды выполнения, укажите 0 в качестве дескриптора соединения.

Опция ConnectTimeOut может быть установлена только на уровне Visual FoxPro и е имеет эквивалента на уровне соединения. Все остальные опции можно задавать как на уровне соединения, так и на уровне Visual FoxPro. Каждая опция, установлен ая на уровне Visual FoxPro, будет приниматься по умолчанию всеми последующими соединениями.

Для получения текущего значения конкретной установки, пользуйтеь функцией SQLGETPROP( ).