1 chip  1.1 //%/////////////////////////////////////////////////////////////////////////////
 2           //

 3 kumpf 1.6 // Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Company, IBM,
 4           // The Open Group, Tivoli Systems

 5 chip  1.1 //
 6           // Permission is hereby granted, free of charge, to any person obtaining a copy
 7           // of this software and associated documentation files (the "Software"), to
 8           // deal in the Software without restriction, including without limitation the
 9           // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10           // sell copies of the Software, and to permit persons to whom the Software is
11           // furnished to do so, subject to the following conditions:

12 kumpf 1.6 // 

13 chip  1.1 // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
14           // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
15           // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
16           // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
17           // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
18           // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
19           // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20           // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21           //
22           //==============================================================================
23           //
24           // Author: Chip Vincent (cvincent@us.ibm.com)
25           //
26           // Modified By:
27           //
28           //%/////////////////////////////////////////////////////////////////////////////
29           
30           #ifndef Pegasus_CIMQueryProvider_h
31           #define Pegasus_CIMQueryProvider_h
32           
33           #include <Pegasus/Common/Config.h>

34 kumpf 1.12 #include <Pegasus/Provider/CIMProvider.h>

35 chip  1.1  
36            #include <Pegasus/Common/Array.h>
37            #include <Pegasus/Common/String.h>

38 kumpf 1.10 #include <Pegasus/Common/CIMName.h>

39 chip  1.1  #include <Pegasus/Common/CIMInstance.h>

40 kumpf 1.9  #include <Pegasus/Provider/Linkage.h>

41 chip  1.1  
42            PEGASUS_NAMESPACE_BEGIN
43            
44            /**
45            This class defines the set of methods implemented by an query provider. A providers that derives
46            from this class must implement all methods. The minimal method implementation simply throw the
47            NotSupported exception.
48            */

49 kumpf 1.12 class PEGASUS_PROVIDER_LINKAGE CIMQueryProvider : public virtual CIMProvider

50 chip  1.1  {
51            public:

52 chip  1.4      CIMQueryProvider(void);
53                virtual ~CIMQueryProvider(void);

54 chip  1.1  

55 chip  1.4      /**
56                Instructs the provider to execute the specified query.
57            
58                @param contex contains security and locale information relevant for the lifetime
59                of this operation.
60            
61                @param queryLanguage
62                @param query
63            
64                @param handler asynchronusly processes the results of this operation.
65            
66                @exception NotSupported
67                @exception InvalidParameter
68                */
69                virtual void executeQuery(
70            	const OperationContext & context,

71 kumpf 1.10 	const CIMNamespaceName & nameSpace,

72 chip  1.4  	const String & queryLanguage,
73            	const String & query,

74 kumpf 1.11 	ObjectResponseHandler & handler) = 0;

75 chip  1.1  };
76            
77            PEGASUS_NAMESPACE_END
78            
79            #endif