3(2005-06-09)

💖 CMCIClientFT.enumInstanceNames() 💖

okay so bestie, welcome to manual section 3 🫶 this is the page for CMCIClientFT.enumInstanceNames(), dated 2005-06-09 (yes she's an elder but she still serves 💅). grab a strawberry 🍓 and let's get into it.

---

✨ NAME ✨

CMCIClientFT.enumInstanceNames() — enumerate instance names of a class 👑

---

🌸 SYNOPSIS 🌸

#include <cmci.h>

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

---

🦋 DESCRIPTION 🦋

So what she does is enumerate the Instance Names of the class (and its subclasses) that op defines. that's the whole gig. she's a name-dropper, not a full-detail-dumper.

the arguments, one by one, no skipping:

• cl — the client object pointer. your connection baddie.
• op — an ObjectPath object pointer, and the reference inside it carries the namespace and classname components. so that's where she learns who you're asking about.
• rc — this is where the operation status lands. and listen: it gets suppressed when NULL, so if you pass NULL you simply do not get a status back. your call, bestie 🙈

---

⭐ RETURN VALUE ⭐

When it works out: CMCIClientFT.enumInstanceNames() hands you back a pointer to a CMPIEnumeration object, and that object contains strings for each instance name found for the class. she also sets a successful operation status code in rc. slay ✨

When it does not work out: she returns a NULL pointer and sets the operation status error code plus the corresponding error string in rc. not her finest moment but she's honest about it 😭

---

💀 ERRORS 💀

...literally nothing here. the section exists and it is empty. no cap. 🫥

---

🎀 EXAMPLES 🎀

here's the whole vibe, verbatim, typos and all (they're part of her charm, do not touch them 🙈):

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();
}

so: connect, build an object path for root/cimv2, call the function, and if status.rc is falsy she bails with abort(). main character energy only 🔥

---

🌈 CONFORMING TO 🌈

also empty. nothing listed. we move 💜

---

👑 SEE ALSO 👑

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

go read those if you want the full lore, iykyk 🧚

---

that's the whole page, bestie — you ate it. this little gem came to you from the SFCBroker Client Library, sfcc edition, page 3 dated 2005-06-09. mwah 💅💖