rom/dos/openfromlock.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Open a file from a lock
   6     Lang: english
   7 */
   8 #include <proto/exec.h>
   9 #include <dos/dosextens.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <proto/dos.h>
  15
  16         AROS_LH1(BPTR, OpenFromLock,
  17
  18 /*  SYNOPSIS */
  19         AROS_LHA(BPTR, lock, D1),
  20
  21 /*  LOCATION */
  22         struct DosLibrary *, DOSBase, 63, Dos)
  23
  24 /*  FUNCTION
  25         Convert a lock into a filehandle. If all went well the lock
  26         will be gone. In case of an error it must still be freed.
  27
  28     INPUTS
  29         lock - Lock to convert.
  30
  31     RESULT
  32         New filehandle or 0 in case of an error. IoErr() will give
  33         additional information in that case.
  34
  35     NOTES
  36         Since locks and filehandles in AROS are identical this function
  37         is just the (useless) identity operator and thus can never fail.
  38         It's there for compatibility to Amiga OS.
  39
  40     EXAMPLE
  41
  42     BUGS
  43
  44     SEE ALSO
  45
  46     INTERNALS
  47
  48 *****************************************************************************/
  49 {
  50     AROS_LIBFUNC_INIT
  51     AROS_LIBBASE_EXT_DECL(struct DosLibrary *,DOSBase)
  52
  53     /* Warning: Some very tricky operation ahead ;-). */
  54     return lock;
  55     AROS_LIBFUNC_EXIT
  56 } /* OpenFromLock */