Description
Renames the folder or file under the specified folder.
Execution of this function is kept waiting when CNC is in editing (including the background edit state).
When the specified file is used for NC operation or selected at foreground,
the file cannot be renamed. And in case of the protected file, the file cannot be renamed.
When the specified folder is selected as the current folder or the upper folder
that includes the current folder, the folder cannot be renamed.
Universal Fanuc Driver
Fanuc Focas Library CD
Declaration
Arguments
Specify the library handle. See "Library handle" for details.
Specify the pointer for the string that stores "Current drive + folder + file name".
String length can be up to 242 characters. The string must be NULL terminated.
In case of folder name, place "/" at the end of string.
If there is no "/", it is regarded as the string for file.
Please refer to "General Description (Specifying the folder and file name for FS30i, 0i-D/F and PMi-A.)" for details of the folder name.
Specify the pointer for the string that stores the folder/file name to be renamed.
String length can be up to 33 characters. The string must be NULL terminated.
Return
EW_OK is returned on successful completion, otherwise any value except EW_OK is returned.
The major error codes are as follows.
| Return code | Meaning/Error handling | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(5) |
In order to get more information for this err_no return value, execute cnc_getdtailerr function. The following detail status will be set onto the member, err_no of ODBERR structure.
|
|||||||||||||||
(7) |
Specified file/folder is prohibited from writing. |
|||||||||||||||
(13) |
- CNC is on execution. - CNC is in the emergency stop. |
As for the other return codes or the details, see "Return status of Data window function"
CNC option
For HSSB connection,
For Ethernet connection,
The Ethernet function and the extended driver/library function are necessary. However, in case of Series 0i-D/F, Series 30i and PMi-A, the required CNC option is as follows. When Embedded Ethernet is used,above two optional functions are not required.
When Ethernet board is used,
- only Ethernet function is required.
CNC parameter
This function is not related to CNC parameter.
CNC mode
This function can be used in any CNC mode.
Available CNC
| 0i-A | 0i-B/C(Note) | 0i-D | 0i-F | 15 | 15i | 16 | 18 | 21 | 16i-A | 18i-A | 21i-A | 16i-B | 18i-B | 21i-B | 30i-A | 30i-B | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| M (Machining) | |||||||||||||||||
| T (Turning) | - | ||||||||||||||||
| LC (Loader) | - | - | - | - | - | - | - | - |
| 0i-D | 0i-F | 16i | 18i | 30i-A | 30i-B | |
|---|---|---|---|---|---|---|
| P (Punch press) | - | |||||
| L (Laser) | - | - | - | - | ||
| W (Wire) | - | - |
| Power Mate i-D | |
| Power Mate i-H | |
| Power Motion i-A | O |
| "O" | : | Both Ethernet and HSSB | |
| "E" | : | Ethernet | |
| "H" | : | HSSB | |
| "X" | : | Cannot be used | |
| "-" | : | None |
Note) 0i-C does not support the HSSB function.
