OLE DB 定义的错误接口中的信息

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(PDW)

SQL Server Native Client OLE DB 访问接口报告 OLE DB 定义的错误接口 IErrorInfoIErrorRecords 和 ISQLErrorInfo 中的一些错误和状态信息。

SQL Server Native Client OLE DB 提供程序支持 IErrorInfo 成员函数,如下所示。

成员函数 说明
GetDescription 错误消息说明性字符串。
GetGUID 定义错误的接口的 GUID。
GetHelpContext 不支持。 始终返回零。
GetHelpFile 不支持。 始终返回 NULL。
GetSource “Microsoft SQL Server Native Client”字符串。

SQL Server Native Client OLE DB 提供程序支持使用者可用的 IErrorRecords 成员函数,如下所示。

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

SQL Server Native Client OLE DB 提供程序支持 ISQLErrorInfo::GetSQLInfo 参数,如下所示。

参数 说明
pbstrSQLState 返回错误的 SQLSTATE 值。 SQLSTATE 值在 SQL-92、ODBC 和 ISO SQL 以及 API 规范中定义。 SQL Server 和 SQL Server Native Client OLE DB 提供程序均未定义特定于实现的 SQLSTATE 值。
plNativeError 返回 master.dbo.sysmessages 的 SQL Server 错误编号(如果存在) 。 成功尝试初始化 SQL Server Native Client OLE DB 访问接口数据源后,可以使用本机错误。 在尝试之前,SQL Server Native Client OLE DB 访问接口始终返回零。

另请参阅

错误