blob: bd944b02f485191e6ddbe49c9c67c4fc3cfca8f4 [file] [log] [blame]
.TH 3 2005-06-09 "sfcc" "SFCBroker Client Library"
CMCIClientFT.setInstance() \- Replace class instance
.B #include <cmci.h>
.BI CMPIStatus *
.BI CMCIClientFT.setInstance (CMCIClient* cl,
.BI CMPIObjectPath* op,
.BI CMPIFlags flags,
.BI char** properties,
.BI CMPIStatus* rc);
Replace a class instance with \fIinst\fP using \fIop\fP as reference.
The content of the returned class instance structure can be controled
using the \fIflags\fP parameter.
Arguments are the client object pointer \fIcl\fP, an ObjectPath object
pointer \fIop\fP that contains namespace and classname components,
\fIflags\fP to affect the returned class instance structure content,
\fIproperties\fP array, and \fIrc\fP which returns the operation status
(suppressed when NULL).
The \fIflags\fP argument is a bit mask that can contain
the following flag - \fICMPI_FLAG_IncludeQualifiers\fP.
The \fIproperties\fP array defines what properties should be returned
for the class.
If this argument is not NULL, only the class properties in the list are
If it's NULL all class properties are returned.
When successful the \fBCMCIClientFT.setInstance()\fP function returns a
CMPIStatus object with a successful operation status code.
When unsuccessful it returns the operation error code and
corresponding error string.
Common Manageability Programming Interface (CMPI) - OpenGroup,
CMCIClient(3), CMPIStatus(3), CMPIObjectPath(3), CMPIFlags(3)