AddFileFolder Method

Description

Adds a file system content hierarchy to the Current.

Return Type

A Long value. A count of file system objects added.

Failure Returns a Long with the count MCDBNodes Added..

Failure conditions:
* AddFolder implementation error.
* AddFile implementation error.
* File system access error.

Syntax

object.AddFileFolder (sFileFolderPath, [eOverWrite], [eDataStorage], [sDisplayName])

The AddFileFolder Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDataNodes.
sFileFolderPath	Required. A String value. The root of the file system hierarchy to add. Currently, only a single file system folder may be specified.
eOverWrite	Optional. A mcDataNodeOverwrites enumeration, as described in settings. See AddFile.
eDataStorage	Optional. A mcDataNodeStorageMethods enumeration, as described in settings. See AddFile.
sDisplayName	Optional. A String value. See AddFile

Settings

The settings for eOverWrite are:

Constant		Value	Description
	mcdaton_NoOverwriteMakeNew	0	Default: FALSE - Add new with all content and make new when instead of overwrite.
	mcdaton_Attributes	1	add or overwrite attributes
	mcdaton_AttributesRemoveOld	2	remove any existing attributes (prior to save)
	mcdaton_Data	4	add or overwrite data
	mcdaton_DataRemoveOld	8	remove existing data (prior to save)
	mcdaton_Icons	16	add or overwrite icons
	mcdaton_IconsRemoveOld	32	remove any existing attributes (prior to save)
	mcdaton_Categories	64	add categories
	mcdaton_CategoriesRemoveOld	128	remove any existing categories (prior to save)
	mcdaton_Children	256	add children
	mcdaton_ChildrenRemoveOld	512	remove any existing children (prior to save)
	mcdaton_RemoveOld	682	Overwrite All
	mcdaton_All	1023	Add or Overwrite all
	mcdaton_AllTrue	-1	Legacy support. Same as mcdaton_All.

The settings for eDataStorage are:

Constant		Value	Description
	mcdatnsm_NotSpecified	0	No Value. Use default value specified to the database type.
	mcdatnsm_StoreFilepath	65536	Store the filename of a file (file must be already saved)
	mcdatnsm_StoreFileData	131072	Save the data in the database
	mcdatnsm_StoreCopyFileName	262144	Save to a database managed file and store filename in database
	mcdatnsm_All	458752	Not a valid value. Use for bit mask of possible values.

Remarks

AddFolder() will called for each file system folder and AddFile will be processed for the files in each file system folder. This function will recurse the identified file system hierarchy. The file must have a McDataSource registered for the given sDisplayName. The selection is ignored.