FC_CreateDir - General Information

Overview

Task

Create file folder.

Description

This function creates a folder with a name that is transferred in i_sDirName. You can create folders on the following devices:

• ide0:

• ram0:

You cannot create a directory on a RemoteDevice. The default device is "ide0:".

You must specify the device name, except for the default device, name in i_sDirname. Separate the device name and the folder name by a backslash "\". The folders must exist before you can create subfolders in them. You cannot create a path of folders. No wildcards are permitted in i_sDirname. The function FC_CreateDir() returns 0 as a result if the process was successful. If an error is detected, a negative value is returned in Result. The duration of the process depends on the data memory used. When using a CompactFlash, runtime is typically some 10 ms.

Interface

Return Value

Examples

 FC_CreateDir('ide0:\Test');  

A "Test" folder is created on the "ide0:" device.

FC_CreateDir('Test');  

A "Test" folder is created on the "ide0:" device.

FC_CreateDir('Test1\Test2');  

A "Test2" subfolder is created in the "Test1" folder if a "Test1" folder already exists on the "ide0:" device.