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 » GetNVList

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.

NOTES

	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()

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:

Phenomena

PHA
RSI
SPB
DC

Comments:
$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se