1 chip  1.1 //%/////////////////////////////////////////////////////////////////////////////
  2           //
  3           // Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM
  4           //
  5           // Permission is hereby granted, free of charge, to any person obtaining a copy
  6           // of this software and associated documentation files (the "Software"), to
  7           // deal in the Software without restriction, including without limitation the
  8           // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  9           // sell copies of the Software, and to permit persons to whom the Software is
 10           // furnished to do so, subject to the following conditions:
 11           //
 12           // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
 13           // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 14           // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
 15           // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 16           // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 17           // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 18           // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 19           // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 20           //
 21           //==============================================================================
 22 chip  1.1 //
 23           // Author: Chip Vincent (cvincent@us.ibm.com)
 24           //
 25           // Modified By:
 26           //
 27           //%/////////////////////////////////////////////////////////////////////////////
 28           
 29           #ifndef Pegasus_CIMAssociationProvider_h
 30           #define Pegasus_CIMAssociationProvider_h
 31           
 32           #include <Pegasus/Common/Config.h>
 33           #include <Pegasus/Provider/CIMBaseProvider.h>
 34           
 35           #include <Pegasus/Common/Array.h>
 36           #include <Pegasus/Common/String.h>
 37           #include <Pegasus/Common/CIMReference.h>
 38           #include <Pegasus/Common/CIMInstance.h>
 39           
 40           PEGASUS_NAMESPACE_BEGIN
 41           
 42           /**
 43 chip  1.1 This class defines the set of methods implemented by an association provider. A providers that derives
 44           from this class must implement all methods. The minimal method implementation simply throw the
 45           NotSupported exception.
 46           */
 47           class PEGASUS_PROVIDER_LINKAGE CIMAssociationProvider : public virtual CIMBaseProvider
 48           {
 49           public:
 50           	CIMAssociationProvider(void);
 51           	virtual ~CIMAssociationProvider(void);
 52           
 53           	/**
 54           	
 55           	@param contex contains security and locale information relevant for the lifetime
 56           	of this operation.
 57           
 58           	@param objectName
 59           	@param associationClass
 60           	@param resultClass
 61           	@param role
 62           	@param resultRole
 63           	@param flags
 64 chip  1.1 	@param propertyList
 65           	
 66           	@param handler asynchronusly processes the results of this operation.
 67           	
 68           	@exception NotSupported
 69           	@exception InvalidParameter
 70           	*/
 71           	virtual void associators(
 72           		const OperationContext & context,
 73           		const CIMReference & objectName,
 74           		const String & associationClass,
 75           		const String & resultClass,
 76           		const String & role,
 77           		const String & resultRole,
 78           		const Uint32 flags,
 79           		const Array<String> & propertyList,

 80 chip  1.3 		ResponseHandler<CIMObject> & handler) = 0;

 81 chip  1.1 
 82           	/**
 83           	@param contex contains security and locale information relevant for the lifetime
 84           	of this operation.
 85           	
 86           	@param objectName
 87           	@param associationClass
 88           	@param resultClass
 89           	@param role
 90           	@param resultRole
 91           	
 92           	@param handler asynchronusly processes the results of this operation.
 93           	
 94           	@exception NotSupported
 95           	@exception InvalidParameter
 96           	*/
 97           	virtual void associatorNames(
 98           		const OperationContext & context,
 99           		const CIMReference & objectName,
100           		const String & associationClass,
101           		const String & resultClass,
102 chip  1.1 		const String & role,
103           		const String & resultRole,
104           		ResponseHandler<CIMReference> & handler) = 0;
105           
106           	/**
107           	@param contex contains security and locale information relevant for the lifetime
108           	of this operation.
109           	
110           	@param objectName
111           	@param resultClass
112           	@param role
113           	@param resultRole
114           	@param flags
115           	@param propertyList
116           	
117           	@param handler asynchronusly processes the results of this operation.
118           	
119           	@exception NotSupported
120           	@exception InvalidParameter
121           	*/
122           	virtual void references(
123 chip  1.1 		const OperationContext & context,
124           		const CIMReference & objectName,
125           		const String & resultClass,
126           		const String & role,
127           		const Uint32 flags,
128           		const Array<String> & propertyList,

129 chip  1.3 		ResponseHandler<CIMObject> & handler) = 0;

130 chip  1.1 
131           	/**
132           	@param contex contains security and locale information relevant for the lifetime
133           	of this operation.
134           	
135           	@param objectName
136           	@param resultClass
137           	@param role
138           	
139           	@param handler asynchronusly processes the results of this operation.
140           	
141           	@exception NotSupported
142           	@exception InvalidParameter
143           	*/
144           	virtual void referenceNames(
145           		const OperationContext & context,
146           		const CIMReference & objectName,
147           		const String & resultClass,
148           		const String & role,
149           		ResponseHandler<CIMReference> & handler) = 0;
150           };
151 chip  1.1 
152           PEGASUS_NAMESPACE_END
153           
154           #endif