INFO: Underlying OLE and OLEDB Provider Errors Are Exposed Through ADO

Article translations Article translations
Article ID: 168354 - View products that this article applies to.
This article was previously published under Q168354
Expand all | Collapse all

On This Page

SUMMARY

ActiveX Data Objects (ADO) processes errors by raising them, if possible, into the Errors Collection. The Errors Collection contains one Error object for each error that ADO processed from its underlying provider. Often, the value for these errors is a numeric HRESULT that is raised by a provider such as OLE DB or even OLE itself. Because of these underlying components, they and their HRESULTS are not documented within the ADO online documentation.

This article points to a list of HRESULTS that may be raised to ADO from the more common sources.

MORE INFORMATION

For additional information about a specific error, query on either the hexadecimal or decimal value of the error message, or query on the actual error message.

Two Values, One HRESULT

Depending upon the development environment, and the mechanism that is used to trap error conditions, you may see HRESULTS in one of two forms:
0x80004005  (hex)
-2147467259 (long)
					
They are the same value, but cast differently. In this case, they are the E_FAIL value, which may indicate that neither OLE DB nor its underlying provider was able to positively identify the source of the error.

Oledberr.exe contains a list of HRESULTS that may be raised to ADO from the more common sources. The following file is available for download from the Microsoft Download Center:
Collapse this imageExpand this image
Download
Download Oledberr.exe now
Release Date: August 28, 2002

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base:
119591 How to Obtain Microsoft Support Files from Online Services
Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file.

Properties

Article ID: 168354 - Last Review: August 5, 2004 - Revision: 2.2
APPLIES TO
  • Microsoft ActiveX Data Objects 2.0
  • Microsoft ActiveX Data Objects 2.1
  • Microsoft ActiveX Data Objects 2.5
  • Microsoft ActiveX Data Objects 2.6
  • Microsoft ActiveX Data Objects 2.7
  • Microsoft OLE DB 2.0
  • Microsoft OLE DB 2.1
  • Microsoft OLE DB 2.5
  • Microsoft OLE DB 2.6
Keywords: 
kbdownload kbdatabase kbinfo kbmdacnosweep KB168354
Retired KB Content Disclaimer
This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com