Skip to content

Latest commit

 

History

History
54 lines (44 loc) · 3.18 KB

information-in-error-interfaces.md

File metadata and controls

54 lines (44 loc) · 3.18 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords
Information in Error Interfaces
The OLE DB Driver for SQL Server reports some error and status information in the OLE DB-defined error interfaces IErrorInfo, IErrorRecords, and ISQLErrorInfo.
David-Engel
v-davidengel
05/06/2020
sql
connectivity
reference
OLE DB Driver for SQL Server, errors
IErrorRecords interface
IErrorInfo interface
OLE DB error handling, error interfaces
ISQLErrorInfo interface
errors [OLE DB], error interfaces

Information in Error Interfaces

[!INCLUDE SQL Server]

[!INCLUDEDriver_OLEDB_Download]

The OLE DB Driver for SQL Server reports some error and status information in the OLE DB-defined error interfaces IErrorInfo, IErrorRecords, and ISQLErrorInfo.

The OLE DB Driver for SQL Server supports IErrorInfo member functions as follows.

Member function Description
GetDescription Descriptive error message string.
GetGUID GUID of the interface that defined the error.
GetHelpContext Not supported. Always returns zero.
GetHelpFile Not supported. Always returns NULL.
GetSource String "Microsoft OLE DB Driver for SQL Server".

The OLE DB Driver for SQL Server supports consumer-available IErrorRecords member functions as follows.

Member function Description
GetBasicErrorInfo Fills an ERRORINFO structure with basic information about an error. An ERRORINFO structure contains members that identify the HRESULT return value for the error, and the provider and interface to which the error applies.
GetCustomErrorObject Returns a reference on interfaces ISQLErrorInfo, and ISQLServerErrorInfo.
GetErrorInfo Returns a reference on an IErrorInfo interface.
GetErrorParameters The OLE DB Driver for SQL Server does not return parameters to the consumer through GetErrorParameters.
GetRecordCount Count of error records available.

The OLE DB Driver for SQL Server supports ISQLErrorInfo::GetSQLInfo parameters as follows.

Parameter Description
pbstrSQLState Returns a SQLSTATE value for the error. SQLSTATE values are defined in the SQL-92, ODBC and ISO SQL, and API specifications. Neither [!INCLUDEssNoVersion] nor the OLE DB Driver for SQL Server defined implementation-specific SQLSTATE values.
plNativeError Returns the [!INCLUDEssNoVersion] error number from master.dbo.sysmessages when available. Native errors are available after a successful attempt to initialize a OLE DB Driver for SQL Server data source. Prior to the attempt, the OLE DB Driver for SQL Server always returns zero.

See Also

Errors