This function builds a path name which completely describes the path from the root of the filing system to the file on which the Lock has been obtained. The name returned is of the form: Volume:Dir1/Dir2/Dir3/.../Name\x00
INPUTS
Lock
- Thisis a lock on the file or directory obtained from Lock() or DupLock(), or some such function.
Destination
- This is the area of memory to place the filename in.
NumberNames
- This is the number of names that can be placed in the destination area. You should reserve 31 bytes for each pathname component. The minimum buffer size would be 32 bytes, which would allow room for one name.
RESULT
The resulting pathname will be placed in Destination. If everything goes well, then you get the total length of the pathname, in characters accumulated. If there is a problem (either the buffer is too small, or there was a disk error), you will get a zero.