version 1.24, 2006/01/30 16:17:59
|
version 1.25, 2006/11/14 18:34:54
|
|
|
Constructor. | Constructor. |
The constructor should not do anything. | The constructor should not do anything. |
*/ | */ |
CIMInstanceProvider(void); |
CIMInstanceProvider(); |
| |
/** | /** |
Destructor. | Destructor. |
The destructor should not do anything. | The destructor should not do anything. |
*/ | */ |
virtual ~CIMInstanceProvider(void); |
virtual ~CIMInstanceProvider(); |
| |
/** | /** |
\Label{getInstance} | \Label{getInstance} |
|
|
and deliver this to the CIM Server via the | and deliver this to the CIM Server via the |
<tt>{@link ResponseHandler ResponseHandler}</tt> | <tt>{@link ResponseHandler ResponseHandler}</tt> |
callback. If the specified instance does not exist, this | callback. If the specified instance does not exist, this |
function should throw an <tt>{@link CIMObjectNotFoundException CIMObjectNotFoundException}.</tt> |
function should throw an |
|
<tt>{@link CIMObjectNotFoundException CIMObjectNotFoundException}.</tt> |
</p> | </p> |
| |
<p>A provider can be implemented and registered to perform | <p>A provider can be implemented and registered to perform |
|
|
@param includeClassOrigin indicates whether the returned instances must | @param includeClassOrigin indicates whether the returned instances must |
include the class origin for each of the instance elements. | include the class origin for each of the instance elements. |
| |
@param propertyList If not null, this parameter |
@param propertyList If not null, this parameter specifies the minimum |
specifies the minimum set of properties required in instances returned by this operation. Because |
set of properties required in instances returned by this operation. |
support for this parameter is optional, the instances may contain additional properties not specified |
Because support for this parameter is optional, the instances may |
in the list. NOTE: The provider does NOT receive the client filtering parameters |
contain additional properties not specified in the list. NOTE: The |
localOnly or deepInheritance. These are resolved in the CIMOM into the propertyList. |
provider does NOT receive the client filtering parameters localOnly |
|
or deepInheritance. These are resolved in the CIM Server into the |
|
propertyList. |
| |
@param handler {@link ResponseHandler ResponseHandler} object for | @param handler {@link ResponseHandler ResponseHandler} object for |
delivery of results. | delivery of results. |
|
|
| |
@exception CIMAccessDeniedException | @exception CIMAccessDeniedException |
@exception CIMOperationFailedException | @exception CIMOperationFailedException |
|
|
*/ | */ |
virtual void enumerateInstances( | virtual void enumerateInstances( |
const OperationContext & context, | const OperationContext & context, |
|
|
@param context specifies the client user's context for this operation, | @param context specifies the client user's context for this operation, |
including the User ID. | including the User ID. |
| |
@param instanceReference specifies the fully qualified object path of the instance of interest. |
@param instanceReference specifies the fully qualified object path |
|
of the instance of interest. |
| |
@param instanceObject contains the partial or complete set of | @param instanceObject contains the partial or complete set of |
properties whose values should be changed. | properties whose values should be changed. |
|
|
be updated as specified in the modified instance. If false, no | be updated as specified in the modified instance. If false, no |
qualifiers are explicitly modified by this operation. | qualifiers are explicitly modified by this operation. |
| |
@param propertyList If not null, this parameter |
@param propertyList If not null, this parameter specifies the set |
specifies the set of properties required to be updated in the instance. Support |
of properties required to be updated in the instance. Support for |
for this parameter is NOT optional. Providers that do not support this |
this parameter is NOT optional. Providers that do not support this |
feature must throw a {@link CIMNotSupportedException CIMNotSupportedException} exception. |
feature must throw a |
|
{@link CIMNotSupportedException CIMNotSupportedException} exception. |
NOTE: The provider does NOT receive the client filtering parameters | NOTE: The provider does NOT receive the client filtering parameters |
localOnly or deepInheritance. These are resolved in the CIMOM into the propertyList. |
localOnly or deepInheritance. These are resolved in the CIMOM into |
|
the propertyList. |
| |
@param handler {@link ResponseHandler ResponseHandler} object for | @param handler {@link ResponseHandler ResponseHandler} object for |
delivery of results. | delivery of results. |
|
|
the instanceReference, because an instance name is not defined | the instanceReference, because an instance name is not defined |
until after the instance has been created. | until after the instance has been created. |
| |
@param instanceObject contains the partial or complete instance to create. |
@param instanceObject contains the partial or complete instance to |
If a key property is null, the provider <em>must</em> supply a valid |
create. If a key property is null, the provider <em>must</em> supply |
value for the property or throw a {@link CIMInvalidParameterException |
a valid value for the property or throw a |
CIMInvalidParameterException}. If any property value is invalid, the |
{@link CIMInvalidParameterException CIMInvalidParameterException}. |
provider should throw a {@link CIMInvalidParameterException |
If any property value is invalid, the provider should throw a |
CIMInvalidParameterException}. |
{@link CIMInvalidParameterException CIMInvalidParameterException}. |
| |
@param handler {@link ResponseHandler ResponseHandler} object for | @param handler {@link ResponseHandler ResponseHandler} object for |
delivery of results. If the operation is successful, the provider must | delivery of results. If the operation is successful, the provider must |