Article ID: 183606 - View products that this article applies to.
This article was previously published under Q183606
This article presents some frequently asked questions about programming ActiveX Data Objects (ADO).
Q. What are the ActiveX Data Objects (ADO)?
A. ActiveX Data Objects are a language-neutral object model that expose data raised by an underlying OLE DB Provider. The most commonly used OLE DB Provider is the OLE DB Provider for ODBC Drivers, which exposes ODBC Data sources to ADO.
Q. Where can I get ActiveX Data Objects?
A. ADO is part of the Microsoft Data Access Components (MDAC). ADO can be obtained from the Free Downloads page on this Web site:
http://msdn2.microsoft.com/en-us/data/aa937695.aspxQ. Where is the documentation that comes with ADO?
A. The documentation that comes with ADO is in html format and can be found by downloading the MDAC Software Development Kit (SDK) from the preceding Web site. Make sure to choose the Microsoft Data Access Components SDK Stand Alone Setup option when downloading MDAC 2.0, or the Microsoft Data Access Components SDK Update if downloading MDAC 2.1.
The documentation for the latest version of ADO is also available online at:
http://msdn2.microsoft.com/en-us/library/ms810811.aspxThe documentation for ADO is part of the Platform SDK documentation that comes with the MSDN Library. In the MSDN Library, choose Contents, then Platform SDK | Data Access Services | Microsoft Data Access Components (MDAC) SDK | Microsoft ActiveX Data Objects (ADO).
Q. What is Remote Data Service (RDS) for ActiveX Data Objects (ADO)?
A. Remote Data Service (RDS) is used to transport Active Data Object Recordsets from a server to a client computer. The resulting recordset is cached on the client computer and disconnected from the server. RDS uses a subset of the ADO Object model, the ADOR.Recordset, to provide a low-overhead, high-performance way to marshal recordset data over a network or web.
Q. What is the difference between the ADODB and ADOR objects?
A. The ADODB Library contains additional server side objects (Connection, Command, Error, Parameters, and so forth). These are best used within server side components to communicate with the database.
The ADOR Library is a lighter weight client that allows the manipulation of an existing recordset on the client. It does not include the Connection, Command, Error, or Parameters commands. The ADOR functionality is distributed with the ADO client components.
Q. How do I get started using ADO with C++?
A. The best solution is to use #import, which generates very thin classes around the ADO typelib and lets you manipulate them in a syntax very close to the Visual Basic for Applications (VBA) syntax. Most ADO samples are written using VBA, and #import lets you translate with greater ease than, say, using Microsoft Foundation Class (MFC) OLE's COleDispatchDriver or using COM programming directly. The list of Microsoft Knowledge Base articles that follows will help you to use ADO with #import:
(http://support.microsoft.com/kb/220152/EN-US/ )Sample: ADOVC1 Simple ADO/VC++ Application
(http://support.microsoft.com/kb/173645/EN-US/ )BUG: Access Violation in Msdaer.dll with _com_error Exceptions
(http://support.microsoft.com/kb/173645/EN-US/ )FILE: Adovcbtd.exe #import Using UpdateBatch and CancelBatch
(http://support.microsoft.com/kb/184968/EN-US/ )Adovcsp.exe Demonstrates Using Stored Procedures with ADO
(http://support.microsoft.com/kb/182389/EN-US/ )FILE: Adovcbm.exe ADO 1.5 with #import and Getrows/Bookmarks
(http://support.microsoft.com/kb/166112/EN-US/ )PRB: Conflict with EOF When Using #import with ADO
(http://support.microsoft.com/kb/169496/EN-US/ )INFO: Using ActiveX Data Objects (ADO) via #import in VC++
168354Additionally, the following articles can be found when searching using Visual C++ as the product that will prove useful to ADO developers:
(http://support.microsoft.com/kb/168354/EN-US/ )INFO: Underlying OLE and OLEDB Provider Errors Are Exposed Through ADO
(http://support.microsoft.com/kb/167802/EN-US/ )SAMPLE: EXCEPTEX Traps MFC and Win32 Exceptions
175784Q. How do I find Microsoft Knowledge Base (KB) articles for ADO?
(http://support.microsoft.com/kb/175784/EN-US/ )INFO: Replacing #import's Exception Raising Mechanism
A. Connect to the Microsoft Knowledge Base on the World Wide Web. To access the Microsoft Knowledge Base on the World Wide Web, visit the following Microsoft Web site:
http://support.microsoft.com/searchFor additional information about how to use the Microsoft Knowledge Base, click the article number below to view the article in the Microsoft Knowledge Base:
129725Q. How do I determine ADO's capabilities?
(http://support.microsoft.com/kb/129725/EN-US/ )Obtaining Knowledge Base Articles on the World Wide Web
A. ADO is dependent upon the data provider it uses. The easiest/quickest way is to check the Supports property to confirm that the connection or recordset you opened supports the functionality you actually need. You should also confirm that the CursorType, and LockType match what you expected. If the underlying provider cannot support the cursor you requested, ADO downgrades these properties to get the cursor that is closest to what you requested.
A more in-depth approach involves analyzing the underlying data provider you are using underneath ADO. The most common provider is the OLE DB Provider for ODBC Drivers that exposes ODBC Data sources to ADO. You can use the Properties collection(s) for the Connection, Command, Recordset, and Field objects and compare the results displayed there to the OLE DB Specification and the OLE DB Leveling Document, both included with the OLE DB SDK, available free for download at this URL:
http://msdn2.microsoft.com/en-gb/library/ms713643.aspxNote that ADO will not automatically define each value for each property exposed in the collections. The property will only be set when the operation you are performing with ADO actually needs to use that property exposed by the underlying provider. This is for performance, and varies from other object models such as DAO which initialize any and all properties whether the operation you are performing utilizes them or not.
Using the Recordset.Supports property is the easiest way to verify that what you expect is actually what the provider exposed to you, given the specific type of connection and recordset you have opened.
Article ID: 183606 - Last Review: March 27, 2007 - Revision: 4.3