NAME

       CMCIClientFT.enumInstanceNames() - Enumerate instance names of a class

SYNOPSIS

       #include <cmci.h>

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

DESCRIPTION

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

RETURN VALUE

       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.

ERRORS

EXAMPLES

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

CONFORMING TO

SEE ALSO

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

sfcc                                               2005-06-09                  CMCICLIENTFT.ENUMINSTANCENAMES(3)