1 karl 1.1 <html>
2 <body bgcolor="#CCCCCC">
3 <table width="100%">
4 <tr>
5 <td width="50%" align="bottom"><h1>Enumerate Instances CIM Operation</h1><td>
6 <td width="50%" align="right">
7 <img border=1 src="pegasus/icons/OpenGroupLogo.gif">
8 </td>
9 </tr>
10 </table>
11 <hr>
12 <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient">
13 <INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateInstanceNames">
14 <p>
15
16 <a name="TOP"></a>
17
18 The <TT>enumerateInstanceNames</TT> operation enumerates the
19 names (model paths) of the instances of a CIM Class in the target Namespace.
20 <p><b><a href="#NameSpace">NameSpace</a></b>
21 <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv20"> String that defines the target namespace. See <a href="getnamespaces.html">NameSpace
22 karl 1.1 Operations</a> for more information.
23 <p><b><a href="#ClassName">ClassName</a></b> <INPUT TYPE="text" NAME="ClassName" SIZE=30> Defines
24 name of the Class
25 for which instance names are to be retrieved. This must be a legal
26 class in the repository<p><INPUT TYPE="submit" VALUE="Submit Request">
27 <INPUT TYPE="reset" VALUE="Reset">
28 </form>
29
30 <hr>
31 <h2>RETURN</h2>
32 If successful, the method returns zero or more names of Instances
33 (model paths) that meet the requested criteria.
34
35 If unsuccessful, one of the following status codes MUST be returned by this
36 method, where the first applicable error in the list (starting with the
37 first element of the list, and working down) is the error returned. Any
38 additional method-specific interpretation of the error in is given in
39 parentheses.
40
41 <UL>
42 <LI>CIM_ERR_ACCESS_DENIED
43 karl 1.1 <LI>CIM_ERR_NOT_SUPPORTED
44 <LI>CIM_ERR_INVALID_NAMESPACE
45 <LI>CIM_ERR_INVALID_PARAMETER (including missing,
46 duplicate, unrecognized or otherwise incorrect parameters)
47 <LI>CIM_ERR_INVALID_CLASS (the CIM Class that is the
48 basis for this enumeration does not exist)
49 <LI>CIM_ERR_FAILED (some other unspecified error occurred)</LI>
50 </UL>
51
52 <hr>
53 <h2>Additional Information</h2>
54 <p><b><a name="NameSpace">NameSpace</a></b> The NameSpace parameter is a string that defines the target
55 namespace.
56 <p><a name="ClassName"><b>
57
58 ClassName</b></a> The ClassName input parameter defines the Class that is the
59 basis for the enumeration. The ClassName input must be in the
60 repository
61 <p><a href="#TOP">Go To Top</a>
62 <hr>
63 <h2>C++ Call</h2>
64 karl 1.1 <p>
65
66 <PRE>
67 virtual Array<Reference> enumerateInstanceNames(
68 const String& nameSpace,
69 const String& className) = 0;
70 </PRE>
71 </body>
72 </html>
73
|