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



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


#include <minc2.h>

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


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.


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

Robert VINCENT 2005-03-09