When creating an empty table, the ActiveX access method must know that the working table should not exist in the current memory image and that all the field and index information should be cleared out. DdfAddTableName serves this function. Unlike
DdfAddTable (which adds the current table memory image to the DDF) or
DdfModifyTableName (which changes the current table name but maintains all other information),
DdfAddTableName creates an extra slot in the current table list and clears out all of the field and index information associated with the blank table. It is recommended that
RefreshLocations be set to
False when this is done, so as not to create an empty table in the DDFs.
The new, empty memory image can be populated with the DdfModifyLocation,
FieldList, and
IndexList operations. It can then be written out to the DDFs with
DdfAddTable.