CIMProvider Class Reference
#include <CIMProvider.h>
Inheritance diagram for CIMProvider:![]()
Public Member Functions
CIMProvider () virtual ~CIMProvider () virtual void initialize (CIMOMHandle &cimom)=0 virtual void terminate ()=0 Detailed Description
CIMProvider is the base class for the provider interface. A provider must implement all the interfaces of the CIMProvider class and one or more of its subclasses (such as CIMInstanceProvider). If a provider does not support any of the operations specified by the interfaces, it may just throw a CIMNotSupportedException.
Some of the parameters that are common to the provider operation interfaces are:
The OperationContext parameter contains information about the context for the specified operation, including the user name of the client requesting the operation. It is the provider's responsibility to determine whether the user is authorized to perform the operation. If the operation should not be permitted, the provider must throw a CIMAccessDeniedException.
A CIMObjectPath specifies the CIM object on which the operation is to be performed. This parameter specifies the hostname, namespace, classname, and key values that uniquely identify a CIM instance.
- A ResponseHandler is a callback handle used by the provider to deliver response data to the CIM Server.
Constructor & Destructor Documentation
CIMProvider::CIMProvider ( ) Default constructor for the abstract CIMProvider class.
virtual CIMProvider::~CIMProvider ( ) [virtual]
Destructs the CIMProvider instance.
Member Function Documentation
virtual void CIMProvider::initialize ( CIMOMHandle & cimom ) [pure virtual]
Initializes the provider. This method is called each time the provider is loaded and must complete before any of the other provider methods (other than terminate) are called.
An exception thrown from this method indicates a provider initialization failure which prevents it from processing operation requests.
- Parameters:
cimom Reserved for future use.
virtual void CIMProvider::terminate ( ) [pure virtual]
Performs any cleanup required before the provider is unloaded. This method may be called by the CIM Server at any time, including during initialization. No other provider methods are called after this method is invoked.
Examples of cleanup a provider may perform in this method include:
- Closing files and/or I/O streams
- Releasing resources such as shared memory
- Informing concurrently executing requests to complete immediately (perhaps by setting a global flag)
- Terminating subprocesses
If the PegasusCreateProvider function dynamically instantiates the provider with the "new" operator, then the terminate() method must "delete" it:
void MyProvider::terminate() { ... delete this; }An exception thrown from this method is considered to be a provider error and is ignored.
The documentation for this class was generated from the following file:
- /home/builduser/trunk/pkgs/tog-pegasus/BUILD/pegasus/src/Pegasus/Provider/CIMProvider.h