Description
Changes the attribute of 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 folder is selected as the current folder, the attribute cannot be changed.
Universal Fanuc Driver
Fanuc Focas Library CD
Declaration
Arguments
Specify the library handle. See "Library handle" for details.
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 IDBPDFTDIR structure that stores the information
about folder/file to be changed.
The IDBPDFTDIR structure is as follows.
typedef struct idbpdftdir {
unsigned long slct; /* setting selection */
unsigned long attr; /* setting attribute */
} IDBPDFTDIR;
- slct
- Specify 1 only for the bit to be modified.
Set 0 to the bits that are not described beneath. - attr
- Specify the attribute data you want to set.
Only bit data specified as 1 by "slct" will be changed with the data by "attr". - [attribute of folder]
- [attribute of file]
#0 | : | Editing | 0:permitted | 1:prohibited |
#1 | : | Editing/displaying | 0:permitted | 1:prohibited |
#0 | : | Editing | 0:permitted | 1:prohibited |
#1 | : | Editing/displaying | 0:permitted | 1:prohibited |
#2 | : | Encryption | 0:OFF | 1:ON |
#8..#10 | : | Modify protection level |
Numerical value 0..7 by #10-MSB, #8-LSB | ||
#12..#14 | : | Output protection level |
Numerical value 0..7 by #14-MSB, #12-LSB |
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 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(4) |
When the option of "Protection of Data at Eight Levels" was invalid, the attribute for "Protection of Data at Eight Levels" was specified for argument slct. ("1" was set in either of slct(#8-31).) |
|||||||||||||||
(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. Or, it is protected by the protection level. |
|||||||||||||||
(13) |
CNC is on execution. |
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.