1 karl  1.13 //%2003////////////////////////////////////////////////////////////////////////

 2 chip  1.1  //

 3 karl  1.13 // Copyright (c) 2000, 2001, 2002  BMC Software, Hewlett-Packard Development
 4            // Company, L. P., IBM Corp., The Open Group, Tivoli Systems.
 5            // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L. P.;
 6            // IBM Corp.; EMC Corporation, The Open Group.

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

14 kumpf 1.6  // 

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

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

37 chip  1.1  
38            #include <Pegasus/Common/Array.h>
39            #include <Pegasus/Common/String.h>

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

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

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

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

51 kumpf 1.12 class PEGASUS_PROVIDER_LINKAGE CIMQueryProvider : public virtual CIMProvider

52 chip  1.1  {
53            public:

54 chip  1.4      CIMQueryProvider(void);
55                virtual ~CIMQueryProvider(void);

56 chip  1.1  

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

73 kumpf 1.10 	const CIMNamespaceName & nameSpace,

74 chip  1.4  	const String & queryLanguage,
75            	const String & query,

76 kumpf 1.11 	ObjectResponseHandler & handler) = 0;

77 chip  1.1  };
78            
79            PEGASUS_NAMESPACE_END
80            
81            #endif