==== FS_PATHINFO ====

**Purpose**

Returns information for a specific path or file.   

**Calling Sequence**

<code c>
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;
</code>

**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.