Description

Each open McDBDatabase instance is associated with entries from the local configuration file (McDBLib.Cfg), defining the logical name of the McDBDatabase and its local (or logical remote) Path, along with any number of configuation strings managed and used solely by the database engine. This property will assign and retrieve these values.

Property type

A String value.  

Syntax

object.ConfigString(StringName) [= value]

The ConfigString Property syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBDatabase.
StringNameRequired. A String value.

The string name of the value in the local configuration file whose corresponding value is to be retrieved. This value is case sensitive (i.e. Value is not the same as value).

valueA String value.

Remarks

Configuration files are formatted like Windows configuration and RegEdit4 files. That is, text files of the form <name>=<value>. Some names are reserved for use by the database engine (e.g. name and McODBE), and assigning values to these keys will result in an error being thrown. An empty string is returned when the name specified is not defined or has no value in the local config file.

Exceptions

Error Value Description
E_INVALIDARG &H80070057 The parameter specified for StringName is reserved, and may not be assigned a ConfigString.
E_FAIL &H80004005 The Value specified for StringName is too long. Values must be no more than 250 characters in length.
E_UNEXPECTED &H8001FFFF A framework error occurred attempting to retrieve or set this property.