DdfAddTableName

Applies to:

VAccess

Description

Adds a new table to the current VAccess control memory image, and initializes the associated Location, FieldList, and IndexList so that a new table definition can be added to the dictionary.

Syntax

object. DdfAddTableName tableName

The DdfAddTableName method syntax has these parts:


Part	Description
object	Required. The name of a valid VAccess control.
tableName	Required. The name of the new table in the VAccess memory image. This cannot be the name of an existing table or the method will fail.

Return Value

DdfAddTableName returns a two-byte integer that holds the status of the VAccess control. If this is zero, the operation completed successfully.

Remarks

DdfAddTableName is the first step in defining a new table's metadata. It affects only the VAccess control's memory image, and therefore is unaffected by the current value of RefreshLocations or DdfTransactionMode.

Example

VAEngine.RefreshLocations = False 
VAEngine.DdfAddTableName tableName 
VAEngine.DdfModifyLocation dataLocation 
'set the Fields and indexes 
VAEngine.FieldList = myFieldsVariant 
VAEngine.IndexList = myIndexVariant 
'write changes to DDF - do not need to 
'reset RefreshLocations 
VAEngine.DdfAddTable(True)