(C) 1998 AROS - The Amiga Research OS


NAME

ULONG PathName ( lock , Destination , NumberNames , Destination , , )

LOCATION
In ArpBase at offset 55

SYNOPSIS
BPTR lock
STRPTR Destination
ULONG NumberNames
Length = PathName(Lock Destination
D0 D0 A0 D1

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

EXAMPLE
SEE ALSO

NOTES

BUGS
None known.

INTERNALS

HISTORY
20.10.1998 hkiel
Amiga Research OS
28.03.1998 bergers
Some new functions.