DdfModifyTableName
Applies to
VAccess
Description
Changes the name of the current table and optionally writes the new name to the DDF.
Syntax
object. DdfModifyTableName newName
The DdfModifyTableName method syntax has these parts:
 
Return Value
DdfModifyTableName returns a two-byte integer that holds the status of the VAccess control. If this is zero, the operation completed successfully.
Remarks
DdfModifyTableName will not change the current table, and will fail if a table already exists with the requested name. The TableName property can be used to change the current table. DdfAddTableName can be used to add a new, blank table to the current list of tables.
If RefreshLocations is True, the new table name is also updated in the FILE.DDF record of the data dictionary. If False, the change will only be made to the VAccess memory image. It could be changed later with DdfAddTable.
This method will also cause the value of the TableName property of the control to change to reflect the new name.
See Also
RefreshLocations, TableName, DdfAddTable, DdfAddTableName, DdfModifyLocation