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

NAME

6       CMCICLientFT.enumClasses() - Enumerate classes and subclasss
7

SYNOPSIS

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

DESCRIPTION

19       Enumerate  Classies  using op as reference. The content of the returned
20       classes can be controled using the flags parameter.
21
22       Arguments are the client object pointer cl, ObjectPath  object  pointer
23       op  that  contains  namespace and classname components, flags to affect
24       the returned class structure content, and rc  the  CMPI  return  status
25       (suppressed when NULL).
26
27       The   flags  argument  is  a  bit  mask  that  can  contain  the  flags
28       CMPI_FLAG_LocalOnly, CMPI_FLAG_DeepInheritance, CMPI_FLAG_IncludeQuali‐
29       fiers, and CMPI_FLAG_IncludeClassOrigin.
30

RETURN VALUE

32       When  successful  the  CMCIClientFT.enumClasses()  function  returns  a
33       pointer to a CMPIEnumeration object that contains each enumerated class
34       and  sets a successful status code in rc.  When unsuccessful it returns
35       NULL and sets the rc argument with the error code and and corresponding
36       error string.
37

ERRORS

EXAMPLES

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

CONFORMING TO

SEE ALSO

59       Common Manageability Programming Interface (CMPI) - OpenGroup,
60       CMCIClient(3),   CMPIEnumeration(3),  CMPIObjectPath(3),  CMPIFlags(3),
61       CMPIStatus(3)
62
63
64
65SFCBroker Client Library             sfcc                        3(2005-06-09)
Impressum