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 kumpf 1.5 #include <Pegasus/Common/CIMPropertyList.h>

 38 chip  1.1 #include <Pegasus/Common/CIMReference.h>
 39           #include <Pegasus/Common/CIMInstance.h>
 40           
 41           PEGASUS_NAMESPACE_BEGIN
 42           
 43           /**
 44           This class defines the set of methods implemented by an association provider. A providers that derives
 45           from this class must implement all methods. The minimal method implementation simply throw the
 46           NotSupported exception.
 47           */
 48           class PEGASUS_PROVIDER_LINKAGE CIMAssociationProvider : public virtual CIMBaseProvider
 49           {
 50           public:

 51 chip  1.4     CIMAssociationProvider(void);
 52               virtual ~CIMAssociationProvider(void);

 53 chip  1.1 

 54 chip  1.4     /**
 55           
 56               @param contex contains security and locale information relevant for the lifetime
 57               of this operation.
 58           
 59               @param objectName
 60               @param associationClass
 61               @param resultClass
 62               @param role
 63               @param resultRole
 64               @param flags
 65               @param propertyList
 66           
 67               @param handler asynchronusly processes the results of this operation.
 68           
 69               @exception NotSupported
 70               @exception InvalidParameter
 71               */
 72               virtual void associators(
 73           	const OperationContext & context,
 74           	const CIMReference & objectName,
 75 chip  1.4 	const String & associationClass,
 76           	const String & resultClass,
 77           	const String & role,
 78           	const String & resultRole,
 79           	const Uint32 flags,

 80 kumpf 1.5 	const CIMPropertyList & propertyList,

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

129 kumpf 1.5 	const CIMPropertyList & propertyList,

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

151 chip  1.1 };
152           
153           PEGASUS_NAMESPACE_END
154           
155           #endif