3(2005-06-09)

✨ 3 — CMCIClientFT.enumClasses() ✨

okay bestie, welcome to manual page 3, section 3 (dated 2005-06-09, we love a vintage moment 💅). This is the one about enumerating classes and, uh, "subclasss" — that's a typo in the original and we're keeping it, it's iconic now 🎀

---

🌸 NAME 🌸

CMCIClientFT.enumClasses() — Enumerate classes and subclasss 💖

---

🦋 SYNOPSIS 🦋

#include <cmci.h>

CMPIEnumeration*
CMCIClientFT.enumClasses(CMCIClient*cl,
                        CMPIObjectPath* op,
                        CMPIFlags flags,
                        CMPIStatus* rc);

---

👑 DESCRIPTION 👑

So basically: you're enumerating Classies using op as the reference. The content of the returned classes can be controled using the flags parameter. ("controled" — yes, one L, that's how the original rolls, we don't gatekeep spelling here 😌)

The arguments are:

• cl — the client object pointer, your main character 🫶
• op — the ObjectPath object pointer, and it's carrying the namespace and classname components
• flags — affects the content of the returned class structure
• rc — the CMPI return status, and heads up: it gets suppressed when NULL 🙈

Now the flags argument is a bit mask, and it can contain:

• CMPI_FLAG_LocalOnly
• CMPI_FLAG_DeepInheritance
• CMPI_FLAG_IncludeQualifiers
• CMPI_FLAG_IncludeClassOrigin

four flags, no more no less, periodt ✨

---

🔥 RETURN VALUE 🔥

When it slays (successful 💅): CMCIClientFT.enumClasses() returns a pointer to a CMPIEnumeration object that contains each enumerated class, and it sets a successful status code in rc. 💖

When it does not slay (unsuccessful 😭): it returns NULL and sets the rc argument with the error code and and corresponding error string. (Yes — "and and". It's in the source. We're preserving the and and. 🫠)

---

💀 ERRORS 💀

nothing here bestie, this section is literally empty. no cap. it's giving mystery. 🕳️✨

---

🌈 EXAMPLES 🌈

okay here's the whole vibe, verbatim, because code is sacred:

   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->enumClasses(cc, objectpath, 0, &status);

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

ngl the formatting in that last block is doing its own thing — the line break inside the fprintf string and that %s0, are exactly how the original prints it, so don't come for me, come for the 2005 source 😭💀

also yes, conncetion is spelled like that up there. it's giving typo, it's giving authentic, we leave it 🎀

---

🧚 CONFORMING TO 🧚

also empty!! the void is voiding 🫧

---

⭐ SEE ALSO ⭐

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

---

and that's the whole page, bestie 🫶 it came from the SFCBroker Client Library, source/version sfcc, dated 2005-06-09 — go forth and enumerate, you absolute icon 👑💖✨