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 chip  1.4     CIMAssociationProvider(void);
 51               virtual ~CIMAssociationProvider(void);

 52 chip  1.1 

 53 chip  1.4     /**
 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               @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 chip  1.4 	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           	ResponseHandler<CIMObject> & handler) = 0;
 81           
 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 chip  1.4     @exception InvalidParameter
 96               */
 97               virtual void associatorNames(
 98           	const OperationContext & context,
 99           	const CIMReference & objectName,
100           	const String & associationClass,
101           	const String & resultClass,
102           	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 chip  1.4 
117               @param handler asynchronusly processes the results of this operation.
118           
119               @exception NotSupported
120               @exception InvalidParameter
121               */
122               virtual void references(
123           	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           	ResponseHandler<CIMObject> & handler) = 0;
130           
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 chip  1.4     @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 chip  1.1 };
151           
152           PEGASUS_NAMESPACE_END
153           
154           #endif