NAME
GetCopyNV -- return a copy of an item stored in nonvolatile storage.
(V40)
SYNOPSIS
data = GetCopyNV(appName, itemName, killRequesters);
D0 A0 A1 D1
aptr getcopynv(strptr, strptr, bool);
FUNCTION
Searches the nonvolatile storage for the indicated appName and
itemName. A pointer to a copy of this data will be returned.
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 found. Maximum length is 31.
itemName - NULL terminated string indicated the item within the
application to be found. Maximum length is 31.
killRequesters - Suppress system requesters flag. TRUE if all system
requesters are to be suppressed during this function.
FALSE if system requesters are allowed.
RESULT
data - pointer to a copy of the data found in the nonvolatile storage
assocated with appName and itemName. NULL will be returned
if there is insufficient memory or the appName/itemName does
not exist.
SEE ALSO
freenvdata(), <libraries/nonvolatile.h>