Функция SQLMORERESULTS( )

Копирует еще одно результирующее множество в курсор Visual FoxPro, если такие езультирующие множества еще есть.

Синтаксис

SQLMORERESULTS(nConnectionHandle)

Параметры

nConnectionHandle

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

Результат

Числовой

Комментарии

Функция SQLMORERESULTS( ) определяет, есть ли еще результирующие множества, по ученные из оператора SQL при выполнении SQLEXEC( ) в режиме обработки, отлич ом от пакетного. Если результирующие множества еще есть, они по одному копи уются в курсор Visual FoxPro.

Функция SQLMORERESULTS( ) возвращает 0, если оператор SQL все еще выполняется, возвращает 1, если он кончил выполняться, и возвращает 2, если данных больше е обнаружено. В режиме, отличном от пакетного, функцию SQLMORERESULTS( ) сле ует вызывать после каждого успешного выполнения SQLEXEC( ), до тех пор, пока SQLMORERESULTS( ) не возвратит 2 (данных больше нет). Чтобы определить, в каком ежиме SQLEXEC( ) выполняет оператор SQL (в пакетном или нет), нужно воспо ьзоваться соответствующей установкой функции SQLSETPROP( ).

В случае ошибки уровня соединения SQLMORERESULTS( ) возвращает 1, а в случае ошибки уровня среды выполнения 2.

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