rom/dos/namefromfh.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Retrieve the full pathname from a filehandle.
   6     Lang: english
   7 */
   8 #include <proto/exec.h>
   9 #include <dos/filesystem.h>
  10 #include "dos_intern.h"
  11
  12 #include <aros/debug.h>
  13
  14 BOOL namefrom_internal(struct DosLibrary *DOSBase, BPTR lock, STRPTR buffer, LONG length, BOOL filehandle);
  15
  16 /*****************************************************************************
  17
  18     NAME */
  19 #include <proto/dos.h>
  20
  21         AROS_LH3(BOOL, NameFromFH,
  22
  23 /*  SYNOPSIS */
  24         AROS_LHA(BPTR,   lock,   D1),
  25         AROS_LHA(STRPTR, buffer, D2),
  26         AROS_LHA(LONG,   length, D3),
  27
  28 /*  LOCATION */
  29         struct DosLibrary *, DOSBase, 68, Dos)
  30
  31 /*
  32     FUNCTION
  33         Get the full path name associated with file-handle into a
  34         user supplied buffer.
  35
  36     INPUTS
  37         fh     - File-handle to file or directory.
  38         buffer - Buffer to fill. Contains a NUL terminated string if
  39                  all went well.
  40         length - Size of the buffer in bytes.
  41
  42     RESULT
  43         !=0 if all went well, 0 in case of an error. IoErr() will
  44         give additional information in that case.
  45
  46 *****************************************************************************/
  47 /*AROS alias NameFromFH NameFromLock */
  48 {
  49     AROS_LIBFUNC_INIT
  50
  51     return namefrom_internal(DOSBase, lock, buffer, length, TRUE);
  52
  53     AROS_LIBFUNC_EXIT
  54 }