Man Linux: Main Page and Category List

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)