13(2005-06-09)                                                    3(2005-06-09)
2
3
4

NAME

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

SYNOPSIS

9       #include <cmci.h>
10
11       CMPIEnumeration*
12       CMCIClientFT.enumInstanceNames(CMCIClient*cl,
13                      CMPIObjectPath*op,
14                      CMPIStatus*rc);
15
16

DESCRIPTION

18       Enumerate Instance Names of the class (and subclasses) defined by op.
19
20       Arguments  are  the  client  object  pointer  cl,  an ObjectPath object
21       pointer op with the reference that  contains  namespace  and  classname
22       components,  and rc which returns the operation status (suppressed when
23       NULL).
24

RETURN VALUE

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

ERRORS

EXAMPLES

34          CMCIClient *cc;
35          CMPIObjectPath * objectpath;
36          CMPIInstance * instance;
37          CMPIEnumeration * enumeration;
38          CMPIStatus status;
39
40          /* Setup a conncetion to the CIMOM */
41          cc = cmciConnect("localhost", NULL, NULL, NULL, NULL, NULL);
42
43          objectpath = newCMPIObjectPath("root/cimv2", NULL, NULL);
44          enumeration = cc->ft->enumInstanceNames(cc, objectpath, &status);
45
46          if (!status.rc) {       fprintf(stderr,  "operation  error  code  %d
47       description     %s0,                    status.rc,    status.msg->hdl);
48            abort();
49          }
50

CONFORMING TO

SEE ALSO

53       Common Manageability Programming Interface (CMPI) - OpenGroup,
54       CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIStatus(3)
55
56
57
58SFCBroker Client Library             sfcc                        3(2005-06-09)