FS_PATHINFO - Query/Set a File's Information

Purpose   

Returns information for a specific path or file. 

Calling Sequence   

int far pascal FS_PATHINFO(flag, pcdfsi, pcdfsd, pName, iCurDirEnd, level,
                           pData, cbData)

unsigned short flag;
struct cdfsi far * pcdfsi;
struct cdfsd far * pcdfsd;
char far * pName;
unsigned short iCurDirEnd;
unsigned short level;
char far * pData;
unsigned short cbData;

Where   

flag indicates retrieval or setting of information. 

flag == 0x0000 indicates retrieving information 
flag == 0x0001 indicates setting information on the media 
flag == 0x0010 indicates that the information being set must be 
written-through onto the disk before returning. This bit is never set when 
retrieving information. 

All other values are reserved. 

pcdfsi is a pointer the file-system-independent working directory 
structure . 

pcdfsd is a pointer to the file-system-dependent working directory 
structure . 

pName is a pointer to the ASCIIZ name of the file or directory for which 
information is to be retrieved or set. 

The FSD does not need to verify 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. 

level is the information level to be returned. 

Level selects among a series of data structures to be returned or set. 

pData is the address of the application data area. 

Addressing of this data area is not validated by the kernel (see 
FSH_PROBEBUF ). When retrieval (flag == 0) is specified, the FSD places 
the information into the buffer. When outputting information to a file 
(flag == 1), the FSD retrieves that data from the application buffer. 

cbData is the length of the application data area. 

For flag == 0, this is the length of the data the application wishes to 
retrieve. If there is not enough room for the entire level of data to be 
returned, the FSD returns a BUFFER OVERFLOW error. For flag == 1, this is 
the length of data to be applied to the file. 
  

Remarks   

See the descriptions of DosQPathInfo and DosSetPathInfo in the OS/2 
Version 2 .0 Control Program Programming Reference for details on 
information levels. 

The FSD will not be called for DosQPathInfo level 5. 

FSDs that are case-preserving (like HPFS) can decide to accept level 7 
requests. A level 7 DosQueryPathInfo request asks the FSD to fill the 
pData buffer with the case-preserved path and filename of the 
path/filename passed in pName. Routing of level 7 requests will be 
determined by the kernel by checking the LV7 bit in a FSD's attribute 
double word.