3(2005-06-09)

💖 3 — CMCIClientFT.enumClassNames() 💖

okay bestie, welcome to section 3 of the manual (dated 2005-06-09, yes she's vintage, she's still iconic) 💅 this is a CMPI-adjacent client-library page from the SFCBroker Client Library (sfcc), and she's here to hand you a whole list of class names. let's get into it 🦋

---

✨ NAME ✨

CMCIClientFT.enumClassNames() — Enumerate class names

---

🌸 SYNOPSIS 🌸

#include <cmci.h>

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

---

💅 DESCRIPTION 💅

so the whole vibe is: you Get a Class, using op as your reference. and the content of the class structure you get back? you get to control that with the flags parameter. main character energy fr ✨

the arguments are, in order:

• cl — the client object pointer. that's your client, your girl 🫶
• op — an ObjectPath object pointer that contains the namespace and classname components
• flags — the flags that affect what the returned class structure content looks like
• rc — the CMPI return status. and heads up: it gets suppressed when NULL 🙈

the flags argument is a bit mask, and the one flag it can contain is CMPI_FLAG_DeepInheritance. periodt 💫

---

🎀 RETURN VALUE 🎀

when everything slays (successful), CMCIClientFT.enumClassNames() returns a pointer to a CMPIEnumeration object that contains each class name found, and it sets a successful status code in rc. 🥳

when it does not work out (unsuccessful), it returns NULL and sets the rc argument with the error code and the corresponding error string. not the moment, but we move 💀

---

⭐ ERRORS ⭐

(this section is empty in the original, bestie — nothing listed, no cap)

---

🌈 EXAMPLES 🌈

   CMCIClient *cc;
   CMPIObjectPath * objectpath;
   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->enumClassNames(cc, objectpath, 0, &status);

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

(yes, the typo in the comment and the %s0, are exactly how she is in the original — we do not touch, we do not fix, we copy verbatim 🫡✨)

---

🧚 CONFORMING TO 🧚

(also empty in the original — she's mysterious, she's giving nothing here 💜)

---

👑 SEE ALSO 👑

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

---

okay that's the whole page, bestie, you ate that 🍓 go forth and enumerate those class names, and remember: check your rc, she will tell you everything iykyk 💖

SFCBroker Client Library · sfcc · 3(2005-06-09) — mwah, that's the source, version and date, signin' off like the legend she is 🌸🦋💅