1
.TH 3 2005-06-09 "sfcc" "SFCBroker Client Library"
3
CMCIClientFT.enumInstances() \- Enumerate instances of a class
9
.BI CMCIClientFT.enumInstances (CMCIClient* cl,
11
.BI CMPIObjectPath* op,
15
.BI char** properties,
22
Enumerate Instances of the class (and subclasses) defined by \fIop\fP.
23
The instance structure and inheritance scope can be controled using the
26
Arguments are the client object pointer \fIcl\fP, an ObjectPath object
27
pointer \fIop\fP with the reference that contains namespace and classname
29
\fIflags\fP that affect the content of the returned class instance structures,
30
a \fIproperties\fP array, and \fIrc\fP which returns the operation status
31
(suppressed when NULL).
33
The \fIflags\fP argument is a bit mask that can contains the following
34
flags - \fICMPI_FLAG_LocalOnly\fP, \fICMPI_FLAG_DeepInheritance\fP,
35
\fICMPI_FLAG_IncludeQualifiers\fP and \fICMPI_FLAG_IncludeClassOrigin\fP.
37
When successful the \fBCMCIClientFT.enumInstances()\fP function returns
38
a pointer to a CMPIEnumeration object that contains the class instances
39
found for the class and sets a successful operation status code in \fIrc\fR.
40
When unsuccessful it returns a NULL pointer and sets the operation
41
status error code and corresponding error string in \fIrc\fP.
46
CMPIObjectPath * objectpath;
47
CMPIInstance * instance;
48
CMPIEnumeration * enumeration;
51
/* Setup a conncetion to the CIMOM */
52
cc = cmciConnect("localhost", NULL, NULL, NULL, NULL, NULL);
54
objectpath = newCMPIObjectPath("root/cimv2", NULL, NULL);
55
enumeration = cc->ft->enumInstances(cc, objectpath, 0, NULL, &status);
58
fprintf(stderr, "operation error code %d description %s\n",
59
status.rc, status.msg->hdl);
65
Common Manageability Programming Interface (CMPI) - OpenGroup,
67
CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIFlags(3),