Functions that support the invocation of methods defined for a CIM class.

Documentation

Functions that support the invocation of methods defined for a CIM class.

The Method Provider supports the client InvokeMethod operation that invokes any method(s) defined on a CIM class of object. In addition to the methods from the CIMProvider interface that the functions inherit, the Method Provider interface defines one function:

• invokeMethod

The arguments to invokeMethod specify the instance that the method invokes, the method name, and its parameters.

Providers that derive from this class must implement all of these functions. A minimal implementation of invokeMethod may throw a CIMNotSupportedException exception.

A method provider is not required to implement all of the CIM methods defined for a class; there can be more than one method provider for a class. Each provider may implement a subset of the defined methods, leaving other methods providers to implemente methods. No method can be implemented by more than one provider. The methods that are implemented by a provider must be specified to the CIM Server through provider registration in the SupportedMethods property of an instance of the PG_ProviderCapabilities class.

Inheritance:

Public Methods

	CIMMethodProvider (void) Constructs a CIMMethodProvider object with null values (default constructor)
virtual	~CIMMethodProvider (void) CIMMethodProvider destructor
virtual void	invokeMethod ( const OperationContext & context, const CIMObjectPath & objectReference, const CIMName & methodName, const Array<CIMParamValue> & inParameters, MethodResultResponseHandler & handler) Invoke the specified method on the specified instance.

Inherited from CIMProvider:

Public Methods

virtual void initialize(CIMOMHandle & cimom)

virtual void terminate(void)

virtual Boolean tryTerminate(void)

CIMMethodProvider(void)

Constructs a CIMMethodProvider object with null values (default constructor)

virtual ~CIMMethodProvider(void)

CIMMethodProvider destructor

virtual void invokeMethod( const OperationContext & context, const CIMObjectPath & objectReference, const CIMName & methodName, const Array<CIMParamValue> & inParameters, MethodResultResponseHandler & handler) = 0

Invoke the specified method on the specified instance.

Instructs the provider to invoke the method specified in the methodName parameter on the object specified in the objectReference parameter.

Throws:

CIMNotSupportedException If the method is not supported.
CIMInvalidParameterException If the parameter is invalid.
CIMObjectNotFoundException If the object is not found.
CIMAccessDeniedException If the user requesting the action is not authorized to perform the action.
CIMOperationFailedException If the operation fails.

Parameters:

context - Specifies the client user's context for this operation, including the user ID.
objectReference - Specifies the fully qualified object path of the class or instance of interest.
methodName - Specifies the name of the method of interest.
inParameters - Specifies the input parameters of the method.
handler - A ResponseHandler object used to deliver results to the CIM Server.

This class has no child classes.

Alphabetic index HTML hierarchy of classes or Java