Диагностические записи

Связанные с каждой средой, соединением, оператором и дескриптором дескриптора являются диагностическими записями. Эти записи содержат диагностические сведения о последней функции, которая использовала конкретный дескриптор. Записи заменяются только при вызове другой функции с помощью этого дескриптора. Количество диагностических записей, которые можно хранить в любое время, не ограничено.

Существует два типа диагностических записей: запись заголовка и ноль или более записей состояния. Запись заголовка имеет значение 0; Записи состояния — это записи 1 и выше. Диагностические записи состоят из ряда отдельных полей, которые отличаются для записи заголовка и записей состояния. Кроме того, компоненты ODBC могут определять собственные поля диагностических записей.

Хотя диагностические записи могут рассматриваться как структуры, для них фактически не требуется быть структурами; как драйвер хранит диагностические сведения, зависят от драйвера.

Поля в диагностических записях извлекаются с помощью SQLGetDiagField. Поля состояния SQLSTATE, собственный номер ошибки и поля диагностических сообщений записей состояния можно получить в одном вызове с помощью SQLGetDiagRec.

Этот раздел содержит следующие подразделы.

• Запись заголовка

• Записи состояния