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

  3 kumpf 1.7 // 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.7 // 

 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_CIMAssociationProvider_h
 31           #define Pegasus_CIMAssociationProvider_h
 32           
 33           #include <Pegasus/Common/Config.h>
 34 chip  1.1 #include <Pegasus/Provider/CIMBaseProvider.h>
 35           
 36           #include <Pegasus/Common/Array.h>
 37           #include <Pegasus/Common/String.h>

 38 kumpf 1.5 #include <Pegasus/Common/CIMPropertyList.h>

 39 kumpf 1.6 #include <Pegasus/Common/CIMObjectPath.h>

 40 chip  1.1 #include <Pegasus/Common/CIMInstance.h>
 41           
 42           PEGASUS_NAMESPACE_BEGIN
 43           
 44           /**
 45           This class defines the set of methods implemented by an association 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           class PEGASUS_PROVIDER_LINKAGE CIMAssociationProvider : public virtual CIMBaseProvider
 50           {
 51           public:

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

 54 chip  1.1 

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

 75 kumpf 1.6 	const CIMObjectPath & objectName,

 76 chip  1.4 	const String & associationClass,
 77           	const String & resultClass,
 78           	const String & role,
 79           	const String & resultRole,
 80           	const Uint32 flags,

 81 kumpf 1.5 	const CIMPropertyList & propertyList,

 82 chip  1.4 	ResponseHandler<CIMObject> & handler) = 0;
 83           
 84               /**
 85               @param contex contains security and locale information relevant for the lifetime
 86               of this operation.
 87           
 88               @param objectName
 89               @param associationClass
 90               @param resultClass
 91               @param role
 92               @param resultRole
 93           
 94               @param handler asynchronusly processes the results of this operation.
 95           
 96               @exception NotSupported
 97               @exception InvalidParameter
 98               */
 99               virtual void associatorNames(
100           	const OperationContext & context,

101 kumpf 1.6 	const CIMObjectPath & objectName,

102 chip  1.4 	const String & associationClass,
103           	const String & resultClass,
104           	const String & role,
105           	const String & resultRole,

106 kumpf 1.6 	ResponseHandler<CIMObjectPath> & handler) = 0;

107 chip  1.4 
108               /**
109               @param contex contains security and locale information relevant for the lifetime
110               of this operation.
111           
112               @param objectName
113               @param resultClass
114               @param role
115               @param resultRole
116               @param flags
117               @param propertyList
118           
119               @param handler asynchronusly processes the results of this operation.
120           
121               @exception NotSupported
122               @exception InvalidParameter
123               */
124               virtual void references(
125           	const OperationContext & context,

126 kumpf 1.6 	const CIMObjectPath & objectName,

127 chip  1.4 	const String & resultClass,
128           	const String & role,
129           	const Uint32 flags,

130 kumpf 1.5 	const CIMPropertyList & propertyList,

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

148 kumpf 1.6 	const CIMObjectPath & objectName,

149 chip  1.4 	const String & resultClass,
150           	const String & role,

151 kumpf 1.6 	ResponseHandler<CIMObjectPath> & handler) = 0;

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