Выполняет остановку выполнения соответствующего SQL-оператора.

SQLCANCEL( ) прерывает выполнение Запросов, выполняемых функциями SQLCOLUMNS( ), SQLEXEC( ), SQLMORERESULTS( ), и  SQLTABLES( ), которые выпоняются в Асинхронном режиме (удаленно на сервере данных). Для установки Асинхронного режима выполнения запросов используется функция SQLSETPROP( ), с соответствующим параметром.

SQLCANCEL(nStatementHandle)

Параметры

nStatementHandle

Определяет номер Дескриптора Соединения, для которого выполняется соответствующий SQL-оператор, выполнение которого требуется остановить, или прекратить.

Expand imageВозвращаемое значение

Числового типа. SQLCANCEL( ) возвращает значение = 1, если выполнение SQL-оператора успешно остановлено, возвращает значение = – 1, если произошла ошибка уровня Соединения, или возвращает значение = – 2, если произошла ошибка уровня Окружения (ODBC).

Expand imageПример

В следующем примере предполагается, что функция SQLCONNECT( ) уже выполнена, установлено соединение с источником данных, дескриптор соединения записан в переменную памяти с именем gnHandle.

SQLEXEC( ) выполняет соответствующий SQL-оператор для источника данных, результаты помещаются в соответствующий Курсор. SQLCANCEL( ) выполняет остановку выполнения текущего запроса.

  CopyCode imageКопировать Код
= SQLSETPROP(gnHandle, 'asynchronous', .T.)   && To stop SQLEXEC( )
= SQLEXEC(gnHandle, 'SELECT * FROM authors')
= SQLCANCEL(gnHandle)   && Wrong select statement, cancel

Expand imageСм. также