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_intern.h"
  10
  11 #include <aros/debug.h>
  12
  13 BOOL namefrom_internal(struct DosLibrary *DOSBase, BPTR lock, STRPTR buffer, LONG length, BOOL filehandle);
  14
  15 /*****************************************************************************
  16
  17     NAME */
  18 #include <proto/dos.h>
  19
  20         AROS_LH3(BOOL, NameFromFH,
  21
  22 /*  SYNOPSIS */
  23         AROS_LHA(BPTR,   lock,   D1),
  24         AROS_LHA(STRPTR, buffer, D2),
  25         AROS_LHA(LONG,   length, D3),
  26
  27 /*  LOCATION */
  28         struct DosLibrary *, DOSBase, 68, Dos)
  29
  30 /*
  31     FUNCTION
  32         Get the full path name associated with file-handle into a
  33         user supplied buffer.
  34
  35     INPUTS
  36         fh     - File-handle to file or directory.
  37         buffer - Buffer to fill. Contains a NUL terminated string if
  38                  all went well.
  39         length - Size of the buffer in bytes.
  40
  41     RESULT
  42         !=0 if all went well, 0 in case of an error. IoErr() will
  43         give additional information in that case.
  44
  45 *****************************************************************************/
  46 /*AROS alias NameFromFH NameFromLock */
  47 {
  48     AROS_LIBFUNC_INIT
  49
  50     return namefrom_internal(DOSBase, lock, buffer, length, TRUE);
  51
  52     AROS_LIBFUNC_EXIT
  53 }