| .TH 3 2005-06-09 "sfcc" "SFCBroker Client Library" |
| .SH NAME |
| CMCIClientFT.invokeMethod() \- Invoke a named method of an instance |
| .SH SYNOPSIS |
| .nf |
| .B #include <cmci.h> |
| .sp |
| .BI CMPIEnumeration * |
| .BI CMCIClientFT.invokeMethod (CMCIClient* cl, |
| .br |
| .BI CMPIObjectPath* op, |
| .br |
| .BI const char* method, |
| .br |
| .BI CMPIArgs* in, |
| .br |
| .BI CMPIArgs* out, |
| .br |
| .BI CMPIStatus* rc); |
| .br |
| .sp |
| .fi |
| .SH DESCRIPTION |
| Invoke a named method of an instance defined by the \fIop\fP reference. |
| .PP |
| Arguments are the client object pointer \fIcl\fP, an ObjectPath object |
| pointer \fIop\fP with the reference that contains namespace and classname |
| components, |
| \fImethod\fP pointer to string that identifies the class method, |
| \fIin\fP pointer to the input arguments, |
| \fIout\fP pointer to the output parameters, |
| and \fIrc\fP which returns the operation status (suppressed when NULL). |
| .SH "RETURN VALUE" |
| When successful the \fBCMCIClientFT.invokeMethod()\fP function returns |
| the CMPIData value returned by the method invoked 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. |
| .SH "ERRORS" |
| .sp |
| .SH "EXAMPLES" |
| .sp |
| .SH "CONFORMING TO" |
| .sp |
| .SH "SEE ALSO" |
| Common Manageability Programming Interface (CMPI) - OpenGroup, |
| .br |
| CMCIClient(3), CMPIEnumeration(3), CMPIObjectPath(3), CMPIArgs(3), |
| CMPIStatus(3) |