AdsGetTableHandle25

Advantage Client Engine

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

Syntax

UNSIGNED32 AdsGetTableHandle25 ( ADSHANDLE hConnect, UNSIGNED8 *pucName,

ADSHANDLE *phTable );

Parameters

hConnect (I)

Connection to search for the open table. If this parameter is zero, all connections are searched.

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.

This API is similar to AdsGetTableHandle except that a connection handle can be specified to limit the scope of the search. If zero is specified as the connection handle when calling this API, the behavior is identical to AdsGetTableHandle API.

Example

ulRetCode = AdsGetTableHandle25( hConn, "Table1", &hTable );

See Also

AdsOpenTable

AdsCreateTable

AdsGetTableFilename

AdsGetTableAlias

AdsGetTableHandle