DdfCreateDictionary

Applies to:

VAccess

Description

Creates a new, empty set of DDF files in the location specified by the DdfPath property. It creates this data dictionary without tables, indexes, or fields for your data. You must add these, using DdfCreateTable, DdfAddTableName, DdfAddTable, and DdfAddIndex.

Syntax

object. DdfCreateDictionary bOverwrite

The DdfCreateDictionary method syntax has these parts:


Part	Description
object	Required. The name of a valid VAccess control.
bOverwrite	Required. Boolean specifying whether the VAccess control should overwrite an existing dictionary if one exists.

Return Value

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

Remarks

DdfCreateDictionary creates FILE.DDF, FIELD.DDF, and INDEX.DDF system files, populates them with self-referential system table definition records, and also creates FIELDEXT.DDF and COMMENT.DDF extended dictionary files.

If a dictionary currently exists in the specified DdfPath, the control will check bOverwrite to determine if it should delete the current dictionary and rewrite it. If bOverwrite is True, the existing dictionary will be irreversibly destroyed.