Returns the Advantage Client Engine table handle that corresponds with the DBF (or table) opened in the current work area. The handle can be used to call any Advantage Client Engine API directly.

Syntax

AX_GetAceTableHandle() -> DWORD

Returns

An Advantage Client Engine table handle.

Description

Returns the table (or DBF) handle associated with the current work area. The handle can be used to call any Advantage Client Engine API directly. The APIs can be imported into Visual Objects from the ACE.AEF file.

The AX_GetAceTableHandle function gets the table handle from the current work area. If you are unsure which work area is current, use select() to set it. For example:

select( dbServer:workarea )

or

select( dbServer:alias )

To avoid all ambiguity you could also retrieve the table handle directly from the DBServer object using the Info method. For example:

dbServer:Info( DBI_GET_ACE_TABLE_HANDLE )

DBI_GET_ACE_TABLE_HANDLE is defined in the dbfaxs.aef library.