Retrieves all objects in an object class that match the specified criteria.
#include <diag/diagodm.h>
#include <sys/cfgodm.h>
#include <diag/DiagODM.h>
void * diag_get_list (
void *classp,
char *criteria,
struct listinfo *info,
int max_expect,
int depth)
The diag_get_list subroutine takes an object class and criteria as input, and returns a list of objects that satisfy the input criteria. The subroutine opens and closes the object class around the get if the object class was not previously opened. If the object class was previously opened, the subroutine leaves the object class open when it returns.
| classp | Class symbol identifier returned from a diag_open_class subroutine. If the diag_open_class subroutine has not been called, then this is the structure name of the class normally defined in either the diag/diagodm.h file, diag/DiagODM.h file, or sys/cfgodm.h file. |
| criteria | String that contains the qualifying criteria for selecting objects. |
| info | Structure containing information about the retrieval of the objects. |
| max_expect | Expected number of objects to be returned. This is used to control the increments in which storage for structures is allocated, to reduce the realloc subroutine copy overhead. |
| depth | Number of levels to recurse for objects with linking descriptors. |
Upon successful completion, a pointer to an array of C language structures containing the objects is returned. If no match is found, NULL is returned. If the diag_get_list fails, a value of -1 is returned.