Database Engines:ads
The ACE32 Client Engine Professional
The Xbase++ ADS DatabaseEngines uses the Advantage 32-bit Client Engine (ACE32) to access the Advantage Database Server. After installation of the ADS DatabaseEngine the runtime part of the Advantage 32-Bit Client Engine is installed in the LIB and RUNTIME directories and consists out of the following files:
ACE32.DLL, Advantage 32 bit Client-Engine
AXCWS32.DLL, Advantage Communication DLL
A complete installation package of the Advantage Client Engine including SDK documentation can be downloaded for free from Extended Systems web site at http://resolution.extendedsystems.com/ADS/Product+Detail/Advantage+Client+Engine+API/default.htm
In the event the ADS DatabaseEngine does not support a specific ADS Server functionality the ACE32.DLL and its APIs can be used directly by-passing the ADS DatabaseEngine. Using Xbase++ DllCall(), transparent access to any exposed API by the ACE32 Client Engine is possible. A sample illustrating that approach can be found at \source\samples\adsdbe\scope. In fact, the ADS DatabaseEngine comes with a small set of additional functions which are all implemented in Xbase++.
Furthermore, some of the ACE32 APIs require a connection,table or index handle. Such handles can be obtained easily as shown in the table below:
Xbase++ expressions to obtain ACE32 handle
| Handle type | Expression |
|---|---|
| Connection handle | oSession:GetConnectionHandle() |
| Table handle | DbInfo(ADSDBO_TABLE_HANDLE) |
| Index/Order handle | OrdInfo(ADSORD_INDEX_HANDLE) |
Feedback
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.