AdsGetTableHandle

Advantage Client Engine

Searches through the list of open tables to find the table with the given filename

Syntax

UNSIGNED32

AdsGetTableHandle (UNSIGNED8 *pucName,

ADSHANDLE *phTable);

Parameters

pucName (I)

Table name. The given name will be resolved to full path using the same algorithm as AdsOpenTable.

phTable (O)

Handle of the table if found.

Special Return Codes

AE_TABLE_CACHED

This table is marked as closed after a call to AdsCloseTable, but the close was cached.

AE_NOT_FOUND

A handle to the table was not found.

Remarks

The Advantage Client Engine will attempt to resolve the given name (pucName) to a fully qualified path name and search for a matching filename.

To find open table on a specific connection, use AdsGetTableHandle25.

Example

Click Here

See Also

AdsOpenTable

AdsCreateTable

AdsGetTableFilename

AdsGetTableAlias

AdsGetTableHandle25