a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 nonvolatile.library
  --background--
  DeleteNV
  FreeNVData
  GetCopyNV
  GetNVInfo
  GetNVList
  SetNVProtection
  StoreNV
Include
GuruMeditation
Docs » Autodocs » nonvolatile.library » SetNVProtection

NAME

	SetNVProtection -- set the protection flags. (V40)

SYNOPSIS

	success = SetNVProtection(appName, itemName, mask, killRequesters);
D0 A0 A1 D2 D1
BOOL SetNVProtection(STRPTR, STRPTR, LONG, BOOL);

FUNCTION

	Sets the protection attributes for an item currently in the
nonvolatile storage.
Although 'mask' is LONG only the delete bit, NVEF_DELETE/NVEB_DELETE,
may be set. If any other bits are set this function will return
FALSE.
The strings appName and itemName may not contain the '/' or ':'
characters. It is recommended that these characters be blocked
from user input when requesting AppName and ItemName strings.

INPUTS

	appName - NULL terminated string indicating the application name
to be matched. Maximum length is 31.
itemName - NULL terminated string indicated the item within the
application to be found. Maximum length is 31.
mask - the new protection mask. Only set the delete bit otherwise
this function WILL CRASH.
killRequesters - suppress system requesters flag. TRUE if all system
requesters are to be suppressed during this function.
FALSE if system requesters are allowed.

RESULT

	success - FALSE if the protection could not be change (ie the data
does not exist).

SEE ALSO

GetNVList(), <libraries/nonvolatile.h>

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Crystal

TSL
TRSI
CSL
AOA

Comments:

$VER: d0.se 1.13 Copyright © 2011-2018 Tobias Geijersson support at d0 dot se