NAME
GetNVList -- return a list of the items stored in nonvolatile
storage. (V40)
SYNOPSIS
list = GetNVList(appName, killRequesters);
D0 A0 D1
struct minlist *getnvlist(strptr, bool);
FUNCTION
Returns a pointer to an Exec list of nonvolatile Items associated
with the appName requested.
The string appName may not contain the '/' or ':' characters.
It is recommended that these characters be blocked from user input
when requesting an appName string.
INPUTS
appName - NULL terminated string indicating the application name
to be matched. 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
list - a pointer to an Exec minlist of nventries. a null will be
returned if there is insufficient memory. If there are no
entries in the nonvolatile storage for the AppName, an
empty list will be returned.
NOTE
The protection field contains more bits than are required for
storing the delete protection status. These bits are reserved
for other system usage and may not be zero. When checking for
the delete status use either the field mask NVIF_DELETE, or the
bit definition NVIB_DELETE.
SEE ALSO
freenvdata(), setnvprotection()