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

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:

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.