诊断记录

与每个环境、连接、语句或描述符句柄相关联的是诊断记录。 这些记录包含有关上次调用的使用特定句柄的函数诊断信息。 只有在使用该句柄调用另一个函数时,才可替换这些记录。 一次可以存储的诊断记录数目不受限制。

有两种类型的诊断记录:一个标题记录和零个或多个状态记录。 标题记录为记录 0;状态记录为记录 1 及以上。 诊断记录由许多单独的字段组成,它们不同于标题记录和状态记录。 此外,ODBC 组件还可以定义自己的诊断记录字段。

虽然诊断记录可以被视为结构,但实际上不要求它们是结构:驱动程序如何存储诊断信息取决于驱动程序。

使用 SQLGetDiagField 检索诊断记录中的字段。 可以使用 SQLGetDiagRec 在单个调用中检索状态记录的 SQLSTATE、本机错误号和诊断消息字段。

本部分包含以下主题。