FS FILEATTRIBUTE: Difference between revisions
Appearance
Created page with "Query/Set the attribute of the specified file. ==Syntax== FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) ==Parameters== ;flag indicates retrieval or set..." |
mNo edit summary |
||
Line 1: | Line 1: | ||
Query/Set the attribute of the specified file. | {{DISPLAYTITLE:FS_FILEATTRIBUTE}} | ||
Query/Set the attribute of the specified file. | |||
==Syntax== | ==Syntax== | ||
FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) | FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) | ||
==Parameters== | ==Parameters== | ||
;flag indicates retrieval or setting of attributes, with: | ;flag indicates retrieval or setting of attributes, with: | ||
:flag == 0 indicates retrieving the attribute. | |||
:flag == 0 indicates retrieving the attribute. | :flag == 1 indicates setting the attribute. | ||
:flag == 1 indicates setting the attribute. | :flag == all other values, reserved. | ||
:flag == all other values, reserved. | :The value of flag passed to the FSD will be valid. | ||
;pcdfsi:is a pointer to the file-system independent portion of an open file instance. | |||
:The value of flag passed to the FSD will be valid. | ;pcdfsd:is a pointer to the file-system dependent portion of an open file instance. | ||
;pName:is a pointer to the ASCIIZ name of the file or directory. | |||
;pcdfsi | :The FSD does not need to validate this pointer. | ||
:is a pointer to the file-system independent portion of an open file instance. | ;iCurDirEnd:is the index of the end of the current directory in pName. | ||
:This is used to optimize FSD path processing. If iCurDirEnd == -1, there is no current directory relevant to the name text, that is, a device. | |||
;pcdfsd | ;pAttr:is a pointer to the attribute. | ||
:is a pointer to the file-system dependent portion of an open file instance. | :For flag == 0, the FSD should store the attribute in the indicated location. | ||
:For flag == 1, the FSD should retrieve the attribute from this location and set it in the file or directory. | |||
;pName | :The FSD does not need to validate this pointer. | ||
:is a pointer to the ASCIIZ name of the file or directory. | |||
==Calling Sequence== | |||
== | |||
<PRE> | <PRE> | ||
int far pascal FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) | int far pascal FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) | ||
Line 49: | Line 33: | ||
unsigned short far * pAttr; | unsigned short far * pAttr; | ||
</PRE> | </PRE> | ||
==Remarks== | ==Remarks== | ||
[[Category:IFS Interfaces]] | [[Category:IFS Interfaces]] | ||
Latest revision as of 04:41, 10 February 2020
Query/Set the attribute of the specified file.
Syntax
FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr)
Parameters
- flag indicates retrieval or setting of attributes, with
- flag == 0 indicates retrieving the attribute.
- flag == 1 indicates setting the attribute.
- flag == all other values, reserved.
- The value of flag passed to the FSD will be valid.
- pcdfsi
- is a pointer to the file-system independent portion of an open file instance.
- pcdfsd
- is a pointer to the file-system dependent portion of an open file instance.
- pName
- is a pointer to the ASCIIZ name of the file or directory.
- The FSD does not need to validate this pointer.
- iCurDirEnd
- is the index of the end of the current directory in pName.
- This is used to optimize FSD path processing. If iCurDirEnd == -1, there is no current directory relevant to the name text, that is, a device.
- pAttr
- is a pointer to the attribute.
- For flag == 0, the FSD should store the attribute in the indicated location.
- For flag == 1, the FSD should retrieve the attribute from this location and set it in the file or directory.
- The FSD does not need to validate this pointer.
Calling Sequence
int far pascal FS_FILEATTRIBUTE(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, pAttr) unsigned short flag; struct cdfsi far * pcdfsi; struct cdfsd far * pcdfsd; char far * pName; unsigned short iCurDirEnd; unsigned short far * pAttr;