3(2005-06-09)

💅 CMCIClientFT.createInstance() — Create class instance 💅

okay bestie, so this is a section 3 page (that's library calls, iykyk) and it lives in the 3 manual, dated 2005-06-09. Pull up a chair, we're making a whole new instance and it's gonna be iconic. 🦋

---

✨ SYNOPSIS ✨

#include <cmci.h>

CMPIObjectPath*
CMCIClientFT.createInstance(CMCIClient*cl,
               CMPIObjectPath*op,
               CMPIInstance*inst,
               CMPIStatus*rc);

---

🌸 DESCRIPTION 🌸

So basically: you're creating a class instance, and you use op as your reference. That's the whole vibe. ✨

Now the arguments, one by one, no skipping, periodt:

• cl — the client object pointer. Your main character.
• op — the ObjectPath object pointer, and it's the one holding the namespace and classname components. It's giving "address label for your new baby instance."
• inst — a complete instance object pointer. Complete! Not a half-finished draft, not a situationship, a full instance.
• rc — the CMPI operation status. And here's the tea: it's suppressed when NULL. So if you pass NULL, it just… doesn't report back. 🙈

---

👑 RETURN VALUE 👑

When it slays (successful), CMCIClientFT.createInstance() returns a pointer to a CMPIObjectPath object carrying the new instance reference, and it sets a successful status code for rc. 🎀

When it does NOT slay (unsuccessful), it returns NULL, and it sets the rc argument with the error code and the corresponding error string. So even when it flops, you get receipts.

---

💀 ERRORS 💀

(nothing listed here, bestie — it's literally empty, that's not me skipping it 💜)

---

🌈 EXAMPLES 🌈

(also empty. no examples were given. we're on our own out here. 😭)

---

🫶 SEE ALSO 🫶

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

---

and that's the whole page, no cap 💖 go forth and create instances responsibly ✨

SFCBroker Client Library — sfcc — dated 2005-06-09. mwah, take care of her 🎀💅