blob: 75ef7c156ae7f94f1c3a24e23a2bbb39fe35bacb [file] [log] [blame]
.TH 3 2005-06-09 "sfcc" "SFCBroker Client Library"
CMCIClientFT.enumInstanceNames() \- Enumerate instance names of a class
.B #include <cmci.h>
.BI CMPIEnumeration *
.BI CMCIClientFT.enumInstanceNames (CMCIClient* cl,
.BI CMPIObjectPath* op,
.BI CMPIStatus* rc);
Enumerate Instance Names of the class (and subclasses) defined by \fIop\fP.
Arguments are the client object pointer \fIcl\fP, an ObjectPath object
pointer \fIop\fP with the reference that contains namespace and classname
components, and \fIrc\fP which returns the operation status (suppressed
when NULL).
When successful the \fBCMCIClientFT.enumInstanceNames()\fP function returns
a pointer to a CMPIEnumeration object that contains strings for each instance
name found for the class and sets a successful operation status code
in \fIrc\fR.
When unsuccessful it returns a NULL pointer and sets the operation
status error code and corresponding error string in \fIrc\fP.
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 %s\n",
status.rc, status.msg->hdl);
Common Manageability Programming Interface (CMPI) - OpenGroup,
CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIStatus(3)