Invoke an Extrinsic Method

Return Request

If the Cim Server is unable to perform the extrinsic method invocation, one of the following status codes MUST be returned by the CimServer, where the first applicable error in the list (starting with the first element of the list, and working down) is the error returned. Any additional specific interpretation of the error is given in parentheses.

CIM_ERR_ACCESS_DENIED
CIM_ERR_NOT_SUPPORTED (the CimServer does not support extrinsic method invocations)
CIM_ERR_INVALID_NAMESPACE
CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or otherwise incorrect parameters)
CIM_ERR_NOT_FOUND (the target CIM Class or instance does not exist in the specified namespace)
CIM_ERR_METHOD_NOT_FOUND
CIM_ERR_METHOD_NOT_AVAILABLE (the CimServer is unable to honor the invocation request)
CIM_ERR_FAILED (some other unspecified error occurred)

Additional Description

Any CIM Server is assumed to support extrinsic methods. Extrinsic methods are defined by the Schema supported by the Cim Server. If a Cim Server does not support extrinsic method invocations, it MUST (subject to the considerations described in the rest of this section) return the error code CIM_ERR_NOT_SUPPORTED to any request to execute an extrinsic method. This allows a CIM client to determine that all attempts to execute extrinsic methods will fail.

C++ API

    virtual CIMValue invokeMethod(
		const String& nameSpace,
		const CIMReference& instanceName,
		const String& methodName,
		const Array& inParameters,
		Array& outParameters) = 0;

Demonstration Prepared by the OpenGroup Manageability Work Group Pegasus Development Team

See (http://www.opengroup.org/management) for more information on Pegasus