Skip to content

information-in-error-interfaces.md

Latest commit

 

History

History
57 lines (47 loc) · 3.77 KB

information-in-error-interfaces.md

File metadata and controls

57 lines (47 loc) · 3.77 KB
title Information in Error Interfaces | Microsoft Docs
ms.custom
ms.date 03/14/2017
ms.prod sql
ms.prod_service database-engine, sql-database, sql-data-warehouse, pdw
ms.reviewer
ms.technology native-client
ms.topic reference
helpviewer_keywords
SQL Server Native Client OLE DB provider, errors
IErrorRecords interface
IErrorInfo interface
OLE DB error handling, error interfaces
ISQLErrorInfo interface
errors [OLE DB], error interfaces
ms.assetid 4620f03f-1193-43e7-ba19-ad022737d300
author markingmyname
ms.author maghan
monikerRange >=aps-pdw-2016||=azuresqldb-current||=azure-sqldw-latest||>=sql-server-2016||=sqlallproducts-allversions||>=sql-server-linux-2017||=azuresqldb-mi-current

Information in Error Interfaces

[!INCLUDEappliesto-ss-asdb-asdw-pdw-md]

The [!INCLUDEssNoVersion] Native Client OLE DB provider reports some error and status information in the OLE DB-defined error interfaces IErrorInfo, IErrorRecords, and ISQLErrorInfo.

The [!INCLUDEssNoVersion] Native Client OLE DB provider 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 SQL Server Native Client".

The [!INCLUDEssNoVersion] Native Client OLE DB provider 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 [!INCLUDEssNoVersion] Native Client OLE DB provider does not return parameters to the consumer through GetErrorParameters.
GetRecordCount Count of error records available.

The [!INCLUDEssNoVersion] Native Client OLE DB provider 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 [!INCLUDEssNoVersion] Native Client OLE DB provider 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 [!INCLUDEssNoVersion] Native Client OLE DB provider data source. Prior to the attempt, the [!INCLUDEssNoVersion] Native Client OLE DB provider always returns zero.

See Also

Errors