![]() ![]() |
![]() |
File: [Pegasus] / pegasus / src / Pegasus / Provider / CIMMethodProvider.h
(download)
Revision: 1.20, Sat Feb 5 23:00:25 2005 UTC (19 years, 4 months ago) by karl Branch: MAIN CVS Tags: STABLE, RELEASE_2_5_0-RC1, RELEASE_2_5_0, PEP244_ServerProfile-root, PEP244_ServerProfile-branch, PEP233_EmbeddedInstSupport-root, PEP217_PRE_BRANCH, PEP217_POST_BRANCH, PEP217_BRANCH, PEP214ROOT, PEP214BRANCH, PEP214-root, PEP214-branch, PEP-214B-root, PEGASUS_2_5_0_PerformanceDev-string-end, PEGASUS_2_5_0_PerformanceDev-rootlt, PEGASUS_2_5_0_PerformanceDev-root, PEGASUS_2_5_0_PerformanceDev-r2, PEGASUS_2_5_0_PerformanceDev-r1, PEGASUS_2_5_0_PerformanceDev-lit-end, PEGASUS_2_5_0_PerformanceDev-buffer-end, PEGASUS_2_5_0_PerformanceDev-branch, PEGASUS_2_5_0_PerformanceDev-AtomicInt-branch, PEG25_IBM_5_16_05, NPEGASUS_2_5_0_PerformanceDev-String-root, NNPEGASUS_2_5_0_PerformanceDev-String-branch, BUG_4225_PERFORMANCE_VERSION_1_DONE Branch point for: PEP233_EmbeddedInstSupport-branch Changes since 1.19: +3 -1 lines BUG#: 2656 TITLE: License statement update to 2005 DESCRIPTION: All .h, .cpp and the wql, cql, compile *.l and *.y files along with the .java files in providermanager2/jmpi updated to use the license statement in doc/license.txt Tested on windows and visual test of all diffs. |
//%2005//////////////////////////////////////////////////////////////////////// // // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation, The Open Group. // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; // EMC Corporation; VERITAS Software Corporation; The Open Group. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to // deal in the Software without restriction, including without limitation the // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or // sell copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. // //============================================================================== // //%///////////////////////////////////////////////////////////////////////////// #ifndef Pegasus_CIMMethodProvider_h #define Pegasus_CIMMethodProvider_h #include <Pegasus/Common/Config.h> #include <Pegasus/Provider/CIMProvider.h> #include <Pegasus/Common/Array.h> #include <Pegasus/Common/CIMName.h> #include <Pegasus/Common/CIMObjectPath.h> #include <Pegasus/Common/CIMValue.h> #include <Pegasus/Common/CIMParamValue.h> #include <Pegasus/Provider/Linkage.h> PEGASUS_NAMESPACE_BEGIN /** Functions that support the invocation of methods defined for a CIM class. <p>The <i>Method Provider</i> supports the client InvokeMethod operation that invokes any method(s) defined on a CIM class of object. In addition to the methods from the {@link CIMProvider CIMProvider} interface that the functions inherit, the Method Provider interface defines one function:</p> <ul> <li>{@link invokeMethod invokeMethod}</li> </ul> <p>The arguments to <tt>invokeMethod</tt> specify the instance that the method invokes, the method name, and its parameters.</p> <p>Providers that derive from this class <i>must</i> implement all of these functions. A minimal implementation of <tt>invokeMethod</tt> may throw a {@link CIMNotSupportedException CIMNotSupportedException} exception.</p> <p>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 <tt>SupportedMethods</tt> property of an instance of the <tt>PG_ProviderCapabilities</tt> class.</p> */ class PEGASUS_PROVIDER_LINKAGE CIMMethodProvider : public virtual CIMProvider { public: /** Constructs a CIMMethodProvider object with null values (default constructor). */ CIMMethodProvider(void); /** CIMMethodProvider destructor. */ virtual ~CIMMethodProvider(void); /** Invoke the specified method on the specified instance. <p>Instructs the provider to invoke the method specified in the <tt>methodName</tt> parameter on the object specified in the <tt>objectReference</tt> parameter. @param context Specifies the client user's context for this operation, including the user ID. @param objectReference Specifies the fully qualified object path of the class or instance of interest. @param methodName Specifies the name of the method of interest. @param inParameters Specifies the input parameters of the method. @param handler A {@link ResponseHandler ResponseHandler} object used to deliver results to the CIM Server. @exception CIMNotSupportedException If the method is not supported. @exception CIMInvalidParameterException If the parameter is invalid. @exception CIMObjectNotFoundException If the object is not found. @exception CIMAccessDeniedException If the user requesting the action is not authorized to perform the action. @exception CIMOperationFailedException If the operation fails. */ virtual void invokeMethod( const OperationContext & context, const CIMObjectPath & objectReference, const CIMName & methodName, const Array<CIMParamValue> & inParameters, MethodResultResponseHandler & handler) = 0; }; PEGASUS_NAMESPACE_END #endif
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |