next up previous contents
Next: milist_attr_next Up: ATTRIBUTE/GROUP FUNCTIONS (11) Previous: miset_attr_values   Contents

milist_start

NAME 

milist_start - get list of attributes or groups starting at given path

SYNOPSIS

#include <minc2.h>

int milist_start ( mihandle_t              volume, 
                   const char              *path,
                   int                     flags,
                   milisthandle_t          *handle)

                                                
DESCRIPTION

This function begins listing the attributes or groups in the 
given path.

If the flags argument includes MILIST_RECURSE, then all of the 
paths subgroups will be searched and their attributes or groups 
will be listed as well.

The path string should always end with a slash ("/") character.

The returned handle is used to pass to milist_attr_next() for 
attributes or milist_grp_next() for groups and 
milist_finish() to actually perform the listing operation.

RETURN VALUE

milist_start returns MI_NOERROR if it successfully gets the
attribute(s) or group(s) or MI_ERROR otherwise



Robert VINCENT 2005-03-09