FC_CreateDir - General Information
|
Type: |
Function |
|
Available as of: |
SystemInterface_1.32.6.0 |
|
Versions: |
Current version |
Create file folder.
This function creates a folder with a name that is transferred in i_sDirName. You can create folders on the following devices:
oide0:
oram0:
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.
|
Input |
Data type |
Description |
|---|---|---|
|
i_sDirName |
STRING[80] |
Name of folder that shall be created |
|
Data type |
Description |
|---|---|
|
DINT |
0: No detected error -1: Folder already exists -2: The specified subfolder does not exist or the specified device is on another remote file system -3: Wildcard in "sDirName" -4: General error detected |
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.
