3(2005-06-09)

💖 NAME 💖

CMCIClientFT.referenceNames() — bestie, this one enumerates the association ObjectPaths for a class instance. It's giving "who's associated with me" energy. 🦋

---

✨ SYNOPSIS ✨

#include <cmci.h>

CMPIEnumeration*
CMCIClientFT.referenceNames(CMCIClient*cl,
               CMPIObjectPath*op,
               constchar*resultClass,
               constchar*role,
               CMPIStatus*rc);

---

🌸 DESCRIPTION 🌸

Okay so what this does: it enumerates association instances that refer to the Instance defined by the op reference. That's the whole vibe. 🫶

Now let's meet the arguments, because there are five of them and they all matter:

• cl — the client object pointer. Just your client, being a client. 💅
• op — an ObjectPath object pointer holding the reference that contains the namespace and classname components. This is the Instance everyone's about to be associated with.
• resultClass — if it's not NULL, this is a valid class name used to filter the returned set of association objects. How? By eliminating objects that aren't an Instance of this Class or one of its subclasses. No cap, it prunes the whole friend group. ✂️
• role — if it's not NULL, this is a valid property name used to filter the returned set of instance objects. It eliminates objects that aren't associated to the source object by an association where the source object plays the specified role. Translating that: the name of the property in the association class that refers to the source object has to match the value of this parameter. iykyk. 🎀
• rc — returns the operation status. It gets suppressed when NULL, so if you don't care, don't pass it. 🙈

---

👑 RETURN VALUE 👑

When it's successful, CMCIClientFT.referenceNames() returns a pointer to a CMPIEnumeration object that contains the class association reference objects found that match the association criteria, and it sets a successful operation status code in rc. Slay. ✨

When it's unsuccessful, it returns a NULL pointer and sets the operation status error code and corresponding error string in rc. Sad girl hours, but at least rc tells you why. 😭

---

💀 ERRORS 💀

Nothing listed here in the original, bestie. This section is literally just vibes and empty space. 🕳️

---

🍓 EXAMPLES 🍓

Also empty! No examples were provided, so I'm not gonna invent one and lie to you. Periodt. 🚫

---

🧚 CONFORMING TO 🧚

Yep, this one's blank too. No conformance claims on the page, so we're not making any up. 💜

---

🔥 SEE ALSO 🔥

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

---

and that's the whole page, no notes 💖✨

this lil manual page lives in section 3 and is dated 2005-06-09 — yes, it's an elder but it still ate. It came to you courtesy of the SFCBroker Client Library, version sfcc. 🎀💅