Pegasus CIM Object Broker Documentation

Contents

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

• Alphabetic index
• Hierarchy of classes

The CIMConstInstance class provides a const interface to a CIMInstance object.

Documentation

The CIMConstInstance class provides a const interface to a CIMInstance object. This class is needed because the shared representation model used by CIMInstance does not prevent modification to a const CIMInstance object. Note that the value of a CIMConstInstance object could still be modified by a CIMInstance object that refers to the same data copy.

Inheritance:

Public Methods

	CIMConstInstance () Constructs an uninitialized CIMConstInstance object.
	CIMConstInstance (const CIMConstInstance& x) Constructs a CIMConstInstance object from the value of a specified CIMConstInstance object, so that both objects refer to the same data copy.
	CIMConstInstance (const CIMInstance& x) Constructs a CIMConstInstance object from the value of a specified CIMInstance object, so that both objects refer to the same data copy.
explicit	CIMConstInstance (const CIMObject& x) Constructs a CIMConstInstance object from the value of a specified CIMObject object, so that both objects refer to the same data copy.
explicit	CIMConstInstance (const CIMConstObject& x) Constructs a CIMConstInstance object from the value of a specified CIMConstObject object, so that both objects refer to the same data copy.
	CIMConstInstance (const CIMName& className) Constructs a CIMConstInstance object with the specified class name.
CIMConstInstance&	operator= (const CIMConstInstance& x) Assigns the value of the specified CIMConstInstance object to this object, so that both objects refer to the same data copy.
CIMConstInstance&	operator= (const CIMInstance& x) Assigns the value of the specified CIMInstance object to this object, so that both objects refer to the same data copy.
	~CIMConstInstance () Destructs the CIMConstInstance object
const CIMName&	getClassName () const Gets the class name of the instance.
const CIMObjectPath&	getPath () const Gets the object path for the instance.
Uint32	findQualifier (const CIMName& name) const Finds a qualifier by name.
CIMConstQualifier	getQualifier (Uint32 index) const Gets the qualifier at the specified index.
Uint32	getQualifierCount () const Gets the number of qualifiers in the instance.
Uint32	findProperty (const CIMName& name) const Finds a property by name.
CIMConstProperty	getProperty (Uint32 index) const Gets the property at the specified index.
Uint32	getPropertyCount () const Gets the number of properties in the instance.
CIMObjectPath	buildPath (const CIMConstClass& cimClass) const Builds the object path for this instance, based on the class name and property values in the instance and the Key qualifiers on the properties in the class definition.
CIMInstance	clone () const Makes a deep copy of the instance.
Boolean	identical (const CIMConstInstance& x) const Compares the CIMConstInstance with a specified CIMConstInstance.
Boolean	isUninitialized () const Determines whether the object has been initialized.

CIMConstInstance()

Constructs an uninitialized CIMConstInstance object. A method invocation on an uninitialized object will result in the throwing of an UninitializedObjectException. An uninitialized object may be converted into an initialized object only by using the assignment operator with an initialized object.

CIMConstInstance(const CIMConstInstance& x)

Constructs a CIMConstInstance object from the value of a specified CIMConstInstance object, so that both objects refer to the same data copy.

Parameters:

x - The CIMConstInstance object from which to construct a new CIMConstInstance object.

CIMConstInstance(const CIMInstance& x)

Constructs a CIMConstInstance object from the value of a specified CIMInstance object, so that both objects refer to the same data copy.

Parameters:

x - The CIMInstance object from which to construct a new CIMConstInstance object.

explicit CIMConstInstance(const CIMObject& x)

Constructs a CIMConstInstance object from the value of a specified CIMObject object, so that both objects refer to the same data copy.

Throws:

DynamicCastFailedException If a CIMConstInstance can not be created from the given CIMObject.

Parameters:

x - The CIMObject object from which to construct the CIMConstInstance object.

explicit CIMConstInstance(const CIMConstObject& x)

Constructs a CIMConstInstance object from the value of a specified CIMConstObject object, so that both objects refer to the same data copy.

Throws:

DynamicCastFailedException If a CIMConstInstance can not be created from the given CIMConstObject.

Parameters:

x - The CIMConstObject object from which to construct the CIMConstInstance object.

CIMConstInstance(const CIMName& className)

Constructs a CIMConstInstance object with the specified class name.

Parameters:

className - A CIMName specifying the class name of the instance.

CIMConstInstance& operator=(const CIMConstInstance& x)

Assigns the value of the specified CIMConstInstance object to this object, so that both objects refer to the same data copy.

Parameters:

x - The CIMConstInstance object from which to assign this CIMConstInstance object.

Returns:

A reference to this CIMConstInstance object.

CIMConstInstance& operator=(const CIMInstance& x)

Assigns the value of the specified CIMInstance object to this object, so that both objects refer to the same data copy.

Parameters:

x - The CIMInstance object from which to assign this CIMConstInstance object.

Returns:

A reference to this CIMConstInstance object.

~CIMConstInstance()

Destructs the CIMConstInstance object

const CIMName& getClassName() const

Gets the class name of the instance.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

A CIMName containing the class name.

const CIMObjectPath& getPath() const

Gets the object path for the instance.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

A CIMObjectPath containing the object path.

Uint32 findQualifier(const CIMName& name) const

Finds a qualifier by name.

Throws:

UninitializedObjectException If the object is not initialized.

Parameters:

name - A CIMName specifying the name of the qualifier to be found.

Returns:

Index of the qualifier if found or PEG_NOT_FOUND if not found.

CIMConstQualifier getQualifier(Uint32 index) const

Gets the qualifier at the specified index.

Throws:

IndexOutOfBoundsException If the index is outside the range of qualifiers available for the CIMConstInstance.
UninitializedObjectException If the object is not initialized.

Parameters:

index - The index of the qualifier to be retrieved.

Returns:

The CIMConstQualifier at the specified index.

Uint32 getQualifierCount() const

Gets the number of qualifiers in the instance.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

An integer count of the qualifiers in the CIMInstance.

Uint32 findProperty(const CIMName& name) const

Finds a property by name.

Throws:

UninitializedObjectException If the object is not initialized.

Parameters:

name - A CIMName specifying the name of the property to be found.

Returns:

Index of the property if found or PEG_NOT_FOUND if not found.

CIMConstProperty getProperty(Uint32 index) const

Gets the property at the specified index.

Throws:

IndexOutOfBoundsException If the index is outside the range of properties available for the CIMConstInstance.
UninitializedObjectException If the object is not initialized.

Parameters:

index - The index of the property to be retrieved.

Returns:

The CIMConstProperty at the specified index.

Uint32 getPropertyCount() const

Gets the number of properties in the instance.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

An integer count of the properties in the CIMConstInstance.

CIMObjectPath buildPath(const CIMConstClass& cimClass) const

Builds the object path for this instance, based on the class name and property values in the instance and the Key qualifiers on the properties in the class definition. The returned object path does not include hostname and namespace attributes. Note that this method does not update the path attribute of the CIMInstance.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

A CIMObjectPath containing the object path for the instance.

CIMInstance clone() const

Makes a deep copy of the instance. This creates a new copy of all the instance attributes including qualifiers and properties.

Throws:

UninitializedObjectException If the object is not initialized.

Returns:

A CIMInstance object with a separate copy of the CIMConstInstance object.

Boolean identical(const CIMConstInstance& x) const

Compares the CIMConstInstance with a specified CIMConstInstance.

Throws:

UninitializedObjectException If the object is not initialized.

Parameters:

x - The CIMConstInstance to be compared.

Returns:

True if this instance is identical to the one specified, false otherwise.

Boolean isUninitialized() const

Determines whether the object has been initialized.

Returns:

True if the object has not been initialized, false otherwise.

This class has no child classes.

Friends:

class CIMInstance
class CIMObject
class CIMConstObject
class XmlWriter
class MofWriter
class BinaryStreamer
class SCMOInstance

Alphabetic index HTML hierarchy of classes or Java