Home / Autodocs / dos.library
NAME
- NameFromFH
-
Get the name of an open FileHandle (V36)
SYNOPSIS
success = NameFromFH(fh, buffer, len)
D0 D1 D2 D3
BOOL NameFromFH(BPTR, STRPTR, LONG)
D0 D1 D2 D3
BOOL NameFromFH(BPTR, STRPTR, LONG)
FUNCTION
Returns a fully qualified path for the FileHandle. This function is guaranteed not to write more than len characters into the buffer. The name will be null-terminated. See NameFromLock() for more information.
INPUTS
- fh
-
Lock of object to be examined.
- buffer
-
Buffer to store name.
- len
-
Length of buffer.
NOTES
NameFromFH() may show unpredictable behaviour if the ChangeMode() function was used with a mode which is none of MODE_NEWFILE, MODE_OLDFILE or MODE_READWRITE.
RESULT
- success
-
Success/failure indicator.