| .TH 3 2005-06-09 "sfcc" "SFCBroker Client Library" |
| .SH NAME |
| CMCIClientFT.createInstance() \- Create class instance |
| .SH SYNOPSIS |
| .nf |
| .B #include <cmci.h> |
| .sp |
| .BI CMPIObjectPath * |
| .BI CMCIClientFT.createInstance (CMCIClient* cl, |
| .br |
| .BI CMPIObjectPath* op, |
| .br |
| .BI CMPIInstance* inst, |
| .br |
| .BI CMPIStatus* rc); |
| .br |
| .sp |
| .fi |
| .SH DESCRIPTION |
| Create class instance using \fIop\fP as reference. |
| .PP |
| Arguments are the client object pointer \fIcl\fP, ObjectPath object |
| pointer \fIop\fP that contains namespace and classname components, |
| \fIinst\fP is a complete instance object pointer, and \fIrc\fP the |
| CMPI operation status (suppressed when NULL). |
| .PP |
| .SH "RETURN VALUE" |
| When successful the \fBCMCIClientFT.createInstance()\fP function returns |
| a pointer to a CMPIObjectPath object with the new instance reference and |
| sets a successful status code for \fIrc\fR. |
| When unsuccessful it returns NULL and sets the \fIrc\fP argument with the |
| error code and and corresponding error string. |
| .SH "ERRORS" |
| .sp |
| .SH "EXAMPLES" |
| .sp |
| .SH "SEE ALSO" |
| Common Manageability Programming Interface (CMPI) - OpenGroup, |
| .br |
| CMCIClient(3), CMPIObjectPath(3), CMPIInstance(3), CMPIStatus(3) |