Обработка ошибок и сообщений
Когда приложение вызывает функцию ODBC, драйвер выполняет эту функцию и возвращает диагностические сведения двумя следующими способами. Код возврата указывает на общий успех или ошибку функции ODBC, а диагностические записи предоставляют подробные сведения о функции. Диагностическая запись состоит из записи заголовка и записи состояния. При успешном выполнении функции возвращается как минимум одна диагностическая запись, запись заголовка.
Диагностические сведения используются во время разработки для перехвата программных ошибок, например, недопустимых дескрипторов и синтаксических ошибок в жестко запрограммированных инструкциях SQL. Она также используется во время выполнения для захвата ошибок и предупреждений времени выполнения, например, усечения данных, нарушения правил и синтаксических ошибок в инструкциях SQL, введенных пользователем. Программная логика обычно основана на кодах возврата.
Например, после того, как приложение вызывает функцию SQLFetch для получения строк в результирующем наборе, код возврата указывает, был ли достигнут конец результирующего набора (SQL_NO_DATA), возвращается ли какое-либо информационное сообщение (SQL_SUCCESS_WITH_INFO) или произошла ошибка (SQL_ERROR).
Если драйвер ODBC для собственного клиента SQL Server возвращает что-то кроме SQL_SUCCESS, приложение может вызвать функцию SQLGetDiagRec для получения сведений или сообщений об ошибке. SQLGetDiagRec используется для прокрутки набора сообщений, если их несколько.
Код возврата SQL_INVALID_HANDLE всегда указывает на программную ошибку, поэтому не должен встречаться во время выполнения. Все другие коды возврата предоставляют сведения времени выполнения, хотя SQL_ERROR может означать программную ошибку.
Исходный собственный API MicrosoftSQL Server, DB-библиотека для C, позволяет приложению устанавливать обработку ошибок по обратному вызову и функции обработки сообщений, возвращающие ошибки или сообщения. Некоторые инструкции Transact-SQL, например PRINT, RAISERROR, DBCC и SET, возвращают свои результаты функции обработки сообщений DB-библиотеки, а не результирующему набору. Однако API-интерфейс ODBC не имеет такой возможности обратного вызова. Если драйвер ODBC для собственного клиента SQL Server обнаруживает сообщения, приходящие обратно из SQL Server, он присваивает коду возврата значение SQL_SUCCESS_WITH_INFO или SQL_ERROR и возвращает сообщение в виде одной или нескольких диагностических записей. Поэтому приложение ODBC должно внимательно проверять наличие этих кодов возврата и вызывать SQLGetDiagRec для получения данных сообщения.