Advantage Client Engine
Searches through the list of open tables on the specified connection to find the table with the given filename
UNSIGNED32 AdsGetTableHandle25 ( ADSHANDLE hConnect, UNSIGNED8 *pucName,
ADSHANDLE *phTable );
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. |
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. |
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.
ulRetCode = AdsGetTableHandle25( hConn, "Table1", &hTable );