[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   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>