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


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