Load

Loads the contents of the XML disk file.

If no path is specified, the path returned by GetPath is used. If the function succeeds, the whole content is changed and all saved positions are deleted. The attributes Validate and AFile of the DataSet root element (tag: STXDataSet) are used to control special load features. If the attribute Validate is set to ON or Load, the DataSet content is validated and corrected (if necessary) after loading. The changes/corrections are displayed in a dialog. If the attribute AFile is set to Link, the metadata of all soundfiles contained in (linked to) the DataSet are imported from the soundfile metadata files.

Usage:

Load [ path ; auto ]

Parameters:

path

The path of the XML disk file to be loaded.

auto

The auto parameter is passed to Save.

Result:

0 for success or non-zero error code.