AdsDDFreeTable

Advantage Client Engine

Alters an ADT table and makes it a free Advantage table file. A free Advantage table file can be used without the need of an Advantage Data Dictionary.

Syntax

UNSIGNED32 AdsDDFreeTable

(

UNSIGNED8 *pucTableName,

UNSIGNED8 *pucPassword

)

Parameters

pucTableName (I)

The fully qualified path and table name of the table to be freed.

pucPassword (I)

If the table is encrypted, this parameter can be used to specify the table password. If the table is not encrypted this parameter can be NULL.

Special Return Codes

AE_FREETABLEFAILED

The error text accompanying this code will have a description of the specific failure.

Remarks

AdsDDFreeTable should only be used if the data dictionary the table belongs to no longer exists or is not available. If the data dictionary is available, and you want to remove a table, use the AdsDDRemoveTable API instead. The AdsDDRemoveTable API will correctly handle referential integrity rules, permissions, and other adjustments that need to be made when removing a table to maintain the integrity of the data dictionary.

This is a client-side function that must have direct access to the file passed in the pucTableName parameter. The Advantage Database Server is not used to modify the table, rather raw file I/O operations are used.

See Also

AdsDDRemoveTable

AdsDDAddTable