Jump to content

FS FILEATTRIBUTE: Difference between revisions

From EDM2
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..."
 
Ak120 (talk | contribs)
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.  


:The FSD does not need to validate this pointer. 
==Calling Sequence==
 
;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.
 
==Returns==
==Sample==
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]]
{{DISPLAYTITLE:FS_FILEATTRIBUTE}}

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;

Remarks