workbench/libs/nonvolatile/deletenv.c

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