错误接口中的信息

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

下载 OLE DB 驱动程序

适用于 SQL Server 的 OLE DB 驱动程序在 OLE DB 定义的错误接口 IErrorInfo、IErrorRecords 和 ISQLErrorInfo 中报告某些错误和状态信息 。

OLE DB Driver for SQL Server 支持 IErrorInfo 成员函数,如下所示。

成员函数 说明
GetDescription 错误消息说明性字符串。
GetGUID 定义错误的接口的 GUID。
GetHelpContext 不支持。 始终返回零。
GetHelpFile 不支持。 始终返回 NULL。
GetSource 字符串“适用于 SQL Server 的 Microsoft OLE DB 驱动程序”。

OLE DB Driver for SQL Server 支持使用者可用的 IErrorRecords 成员函数,如下所示。

成员函数 说明
GetBasicErrorInfo 使用有关错误的基本信息填充 ERRORINFO 结构。 ERRORINFO 结构包含标识错误的 HRESULT 返回值的成员、访问接口和该错误适用的接口。
GetCustomErrorObject 返回对 ISQLErrorInfo 和 ISQLServerErrorInfo 接口的引用 。
GetErrorInfo 返回对 IErrorInfo 接口的引用 。
GetErrorParameters OLE DB Driver for SQL Server 不通过 GetErrorParameters 向使用者返回参数。
GetRecordCount 可用错误记录的计数。

OLE DB Driver for SQL Server 支持 ISQLErrorInfo::GetSQLInfo 参数,如下所示。

参数 说明
pbstrSQLState 返回错误的 SQLSTATE 值。 SQLSTATE 值在 SQL-92、ODBC 和 ISO SQL 以及 API 规范中定义。 SQL Server 和 OLE DB Driver for SQL Server 都未定义特定于实现的 SQLSTATE 值。
plNativeError 返回 master.dbo.sysmessages 的 SQL Server 错误编号(如果存在) 。 在初始化 OLE DB Driver for SQL Server 数据源的尝试成功后,本机错误就可返回。 在尝试之前,OLE DB Driver for SQL Server 始终返回零。

另请参阅

错误