workbench/libs/nonvolatile/deletenv.c

   1 /*
   2     Copyright © 1995-2006, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 /*****************************************************************************
   7
   8     NAME */
   9
  10 #ifndef  DEBUG
  11 #define  DEBUG  1
  12 #endif
  13
  14 #include <aros/debug.h>
  15
  16 #include <libraries/nonvolatile.h>
  17 #include <dos/dosextens.h>
  18 #include <proto/nvdisk.h>
  19
  20 #include <string.h>
  21
  22
  23 AROS_LH3(BOOL, DeleteNV,
  24
  25 /*  SYNOPSIS */
  26
  27         AROS_LHA(STRPTR, appName,  A0),
  28         AROS_LHA(STRPTR, itemName, A1),
  29         AROS_LHA(BOOL,   killRequesters, D1),
  30
  31 /*  LOCATION */
  32
  33         struct Library *, nvBase, 8, Nonvolatile)
  34
  35 /*  FUNCTION
  36
  37     Delete a piece of data in the nonvolatile storage.
  38
  39     INPUTS
  40
  41     appName         --  the application owning the data to be deleted; maximum
  42                         length 31
  43     itemName        --  name of the data to be deleted; maximum length 31
  44     killRequesters  --  if set to TRUE no system requesters will be displayed
  45                         during the deletion operation; if set to FALSE, system
  46                         requesters will be allowed to be displayed
  47
  48     RESULT
  49
  50     Success / failure indicator.
  51
  52     NOTES
  53
  54     The 'appName' and 'itemName' strings may NOT include the characters
  55     '/' or ':'.
  56
  57     EXAMPLE
  58
  59     BUGS
  60
  61     SEE ALSO
  62
  63     INTERNALS
  64
  65 ******************************************************************************/
  66
  67 {
  68     AROS_LIBFUNC_INIT
  69
  70     struct Process *me = (struct Process *)FindTask(NULL);
  71     APTR oldReq = me->pr_WindowPtr;
  72     BOOL result;
  73
  74     D(bug("Entering DeleteNV()\n"));
  75
  76     if(appName == NULL || itemName == NULL)
  77         return FALSE;
  78
  79     if(strpbrk(appName, ":/") != NULL ||
  80        strpbrk(itemName, ":/") != NULL)
  81         return FALSE;
  82
  83     if(killRequesters)
  84         me->pr_WindowPtr = (APTR)-1;
  85
  86     D(bug("Calling DeleteData()\n"));
  87
  88     result = DeleteData(appName, itemName);
  89
  90     if(killRequesters)
  91         me->pr_WindowPtr = oldReq;
  92
  93     return result;
  94
  95     AROS_LIBFUNC_EXIT
  96 } /* DeleteNV */