1 karl  1.3 //%2003////////////////////////////////////////////////////////////////////////

 2 tony  1.1 //

 3 karl  1.3 // 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 tony  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           // 
15           // 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: Tony Fiorentino (fiorentino_tony@emc.com)
27           //
28 tony  1.1 // Modified By:
29           //
30           //%/////////////////////////////////////////////////////////////////////////////
31           #ifndef Pegasus_CIMServerDiscovery_h
32           #define Pegasus_CIMServerDiscovery_h
33           
34           #include <Pegasus/Common/Config.h>
35           #include <Pegasus/Common/Array.h>
36           #include <Pegasus/Common/String.h>
37           #include <Pegasus/Client/Attribute.h>
38           #include <Pegasus/Client/CIMServerDescription.h>
39           #include <Pegasus/Client/Linkage.h>
40           
41           PEGASUS_NAMESPACE_BEGIN
42           
43           

44 karl  1.2 //*****************************************************************************

45 tony  1.1 // CIMServerDiscoveryRep

46 karl  1.2 //*****************************************************************************
47           
48           

49 tony  1.1 class CIMServerDiscoveryRep
50           {
51           public:
52           
53             CIMServerDiscoveryRep();
54             ~CIMServerDiscoveryRep();
55           
56             Array<CIMServerDescription> lookup(const Array<Attribute> & criteria);
57           
58           };
59           
60           /** This class provides the interface that a client uses to discover

61 karl  1.2     CIM Servers.
62               ATTN: Add more descriptive material here KS 2 Oct 2003

63 tony  1.1 */
64           class PEGASUS_CLIENT_LINKAGE CIMServerDiscovery
65           {
66           public:
67           
68             /** Constructor for a CIMServerDiscovery object.
69             */
70             CIMServerDiscovery();
71           
72             /** Destructor for a CIMServerDiscovery object
73             */
74             ~CIMServerDiscovery();
75           
76             /** Lookup all WBEM servers
77                 @return  the return value is an array of connection descriptions.
78             */
79             Array<CIMServerDescription> lookup();
80           
81             /** Lookup specific WBEM servers
82                 @param   criteria   Criteria for specifing which CIM Servers to lookup.
83                 @return  the return value is array of connection descriptions.
84 tony  1.1   */
85             Array<CIMServerDescription> lookup(const Array<Attribute> & criteria);
86           
87           private:
88           
89             CIMServerDiscoveryRep* _rep;
90           };
91           
92           PEGASUS_NAMESPACE_END
93           
94           #endif /* Pegasus_CIMServerDiscovery_h */
95           
96           
97