CMCIClientFT.enumInstanceNames - Man Page

#include <cmci.h>

CMPIEnumeration*
CMCIClientFT.enumInstanceNames(CMCIClient*cl,
CMPIObjectPath*op,
CMPIStatus*rc);

Enumerate Instance Names of the class (and subclasses) defined by op.

Arguments are the client object pointer cl, an ObjectPath object  pointer op with the reference that contains namespace and classname components, and rc which returns the operation status (suppressed  when NULL).

When successful the CMCIClientFT.enumInstanceNames() function returns a pointer to a CMPIEnumeration object that contains strings for each instance name found for the class and sets a successful operation status code  in rc. When unsuccessful it returns a NULL pointer and sets the operation  status error code and corresponding error string in rc.

  CMCIClient *cc;
  CMPIObjectPath * objectpath;
  CMPIInstance * instance;
  CMPIEnumeration * enumeration;
  CMPIStatus status;

  /* Setup a conncetion to the CIMOM */  
  cc = cmciConnect("localhost", NULL, NULL, NULL, NULL, NULL);

  objectpath = newCMPIObjectPath("root/cimv2", NULL, NULL);
  enumeration = cc->ft->enumInstanceNames(cc, objectpath, &status);

  if (!status.rc) { fprintf(stderr, "operation error code %d description %s0, status.rc, status.msg->hdl); abort();
  }

Common Manageability Programming Interface (CMPI) - OpenGroup,
CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIStatus(3)

CMCIClient(3).