[an error occurred while processing this directive]
[an error occurred while processing this directive] [an error occurred while processing this directive]

Pegasus CIM Object Broker Documentation
[an error occurred while processing this directive]


[an error occurred while processing this directive]

 

Contents

o Introduction
o Objectives
o Overview
o Credits
o Pegasus Architecture
   o Design Goals
   o The Broker
   o Pegasus Providers.
   o Extension Services
   o Pegasus Clients.
   o Functional Flow
o Pegasus Components
   o Component Descriptions
   o Pegasus Directory Structure
o Pegasus Utilization
   o Pegasus Availability
   o Pegasus Installation
   o Pegasus Operation
   o Pegasus CIM Clients
   o Pegasus Providers
   o Pegasus MOF Compiler
o Programming Pegasus
   o CIM Objects in Pegasus
   o CIM Object Table
   o Class Definitions
o Pegasus Interfaces
   o CIM Operations over HTTP
   o Pegasus Client Interfaces
   o Pegasus Provider Interfaces
   o Pegasus Service Extension Interfaces
   o Repository Interfaces
o Writing Providers.
o Glossary
o Pegasus Code Examples
   o Client Examples
   o Client Coding Examples
   o Provider Coding Examples
o Document References
o Pegausus FAQ
o
In file ../../src/Pegasus/Provider/CIMProvider.h:

class PEGASUS_PROVIDER_LINKAGE CIMProvider

CIMProvider is the base class for the provider interface.

Documentation

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.

Inheritance:

Public Methods

[more] CIMProvider ()
Default constructor for the abstract CIMProvider class
[more]virtual ~CIMProvider ()
Destructs the CIMProvider instance
[more]virtual void initialize (CIMOMHandle & cimom)
Initializes the provider.
[more]virtual void terminate ()
Performs any cleanup required before the provider is unloaded.

o CIMProvider()
Default constructor for the abstract CIMProvider class

ovirtual ~CIMProvider()
Destructs the CIMProvider instance

ovirtual void initialize(CIMOMHandle & cimom) = 0
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.

ovirtual void terminate() = 0
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.

Direct child classes:
CIMMethodProvider
CIMInstanceProvider
CIMIndicationProvider
CIMAssociationProvider

Alphabetic index HTML hierarchy of classes or Java
[an error occurred while processing this directive]