|
version 1.2, 2001/01/30 07:40:22
|
version 1.11, 2002/01/30 21:56:39
|
|
|
|
| <body bgcolor="#CCCCCC"> | <body bgcolor="#CCCCCC"> |
| <table width="100%"> | <table width="100%"> |
| <tr> | <tr> |
| <td width="50%" align="bottom"><h1>EnumerateClassNames</h1><td> |
<td width="50%" align="bottom"><h1>EnumerateClassNames Operation</h1><td> |
| <td width="50%" align="right"> | <td width="50%" align="right"> |
| <img border=1 src="/icons/OpenGroupLogo.gif"> |
<img border=1 src="/pegasus/icons/OpenGroupLogo.gif"> |
| </td> | </td> |
| </tr> | </tr> |
| </table> | </table> |
| <hr></hr> |
<hr> |
| <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> |
<form name="EnumerateClassNames" METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient" > |
| <INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateClassNames"> | <INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateClassNames"> |
| <p>NameSpace |
<INPUT TYPE="hidden" NAME="hostaddress" VALUE="localhost:5988"> |
| <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv20"> |
<INPUT TYPE="hidden" NAME="debug" VALUE=""> |
| The NameSpace parameter is a string that defines the target namespace. |
<p> |
| <p>ClassName <INPUT TYPE="text" NAME="ClassName" SIZE=30> |
The <TT>enumerateClassNames</TT> operation is used to enumerate the |
| <p>DeepInheritance |
names of subclasses of a CIM Class in the target Namespace. |
| <INPUT TYPE="checkbox" NAME="DeepInheritance" VALUE="true" checked> |
<p><b><a href="#NameSpace">NameSpace</a></b> |
| <p><INPUT TYPE="submit" VALUE="EnumerateClassNames"> |
<INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv2"> |
| <p><INPUT TYPE="reset" VALUE="Reset"> |
String that defines the target namespace. See <a href="getnamespaces.html">NameSpace |
| |
Operations</a> for more information.<p><b><a href="http://www.opengroup.org/management#className">ClassName</a></b> |
| |
<INPUT TYPE="text" NAME="ClassName" SIZE=30> |
| |
Defines the name of the Class that is the basis for the enumeration.. Null (no entry) lists all |
| |
class names in the Namespace<p><b><a href="#DeepInheritance">DeepInheritance</a></b> |
| |
<INPUT TYPE="checkbox" NAME="DeepInheritance" VALUE="true" checked> |
| |
If true return names of all subclasses of specified class. If false, only |
| |
immediate subclasses are returned. |
| |
<p><INPUT TYPE="submit" VALUE="Submit Request"> |
| |
<INPUT TYPE="reset" VALUE="Reset"> |
| </form> | </form> |
| |
<hr> |
| |
|
| |
<h2>Request Return </h2> |
| |
|
| |
<p> If successful, the method returns zero or more names of Classes that |
| |
meet the requested criteria as a CIM Array. |
| |
|
| |
<p>If unsuccessful, one of the following status codes MUST be returned by this |
| |
method, where the first applicable error in the list (starting with the |
| |
first element of the list, and working down) is the error returned. Any |
| |
additional method-specific interpretation of the error in is given in |
| |
parentheses. |
| |
<UL> |
| |
<LI>CIM_ERR_ACCESS_DENIED |
| |
<LI>CIM_ERR_NOT_SUPPORTED |
| |
<LI>CIM_ERR_INVALID_NAMESPACE |
| |
<LI>CIM_ERR_INVALID_PARAMETER (including missing, |
| |
duplicate, unrecognized or otherwise incorrect parameters) |
| |
<LI>CIM_ERR_INVALID_CLASS (the CIM Class that is the |
| |
basis for this enumeration does not exist) |
| |
<LI>CIM_ERR_FAILED (some other unspecified error occurred)</LI> |
| |
</UL> |
| |
|
| |
<hr> |
| |
<h2>Additional Information on the Fields</h2> |
| |
<p><a name="NameSpace"><b>NameSpace</b></a> - The NameSpace parameter is a string that defines the |
| |
target namespace |
| |
|
| |
<p><a name="ClassName"><b>className</b></a> - The <TT>ClassName</TT> input parameter defines the Class |
| |
that is the basis for the enumeration. Note that the class named is not |
| |
retrieved as part of the enumeration. Thus, if there are no subclasses to |
| |
the named class, zero classe names are returned. |
| |
|
| |
<p><a name="DeepInheritance"><b>DeepInheritance</b></a> - If the DeepInheritance input parameter is true, this |
| |
specifies that the names of all subclasses of the specified Class should be |
| |
returned (if the ClassName input parameter is absent, this implies that the |
| |
names of all Classes in the target Namespace should be returned). If false, |
| |
only the names of immediate child subclasses are returned (if the ClassName |
| |
input parameter is NULL, this implies that the names of all base Classes in |
| |
the target Namespace should be returned. |
| |
<hr> |
| |
|
| |
<h2>C++ Call</h2> |
| |
|
| |
<PRE> |
| |
virtual Array<String> enumerateClassNames( |
| |
const String& nameSpace, |
| |
const String& className = String::EMPTY, |
| |
Boolean deepInheritance = false) = 0; |
| |
</PRE> |
| |
<hr><p style="margin-top: 0; margin-bottom: 0"> <font size="2">Demonstration |
| |
Prepared by the OpenGroup Manageability Work Group Pegasus Development Team</font> |
| |
|
| |
<p style="margin-top: 0; margin-bottom: 0"> <font size="2">See (<a href="http://www.opengroup.org/management">http://www.opengroup.org/management</a>) |
| |
for more information on Pegasus</font> |
| |
|
| |
<p style="margin-top: 0; margin-bottom: 0"> <font size="1">Last Modified <!--webbot bot="Timestamp" S-Type="EDITED" |
| |
S-Format="%A, %B %d, %Y %I:%M:%S %p" startspan -->Tuesday, January 29, 2002 11:36:22 AM<!--webbot bot="Timestamp" i-CheckSum="11606" endspan --> |
| |
Copyright @ The Open Group 2001 </font> |
| |
|
| |
<script> |
| |
document.EnumerateClassNames.hostaddress.value = top.hostAddress; |
| |
document.EnumerateClassNames.debug.value = top.debug; |
| |
document.EnumerateClassNames.NameSpace.value = top.NameSpace; |
| |
window.focus(); |
| |
</script> |
| |
|
| </body> | </body> |
| </html> | </html> |
Return to
EnumerateClassNames.html
CVS log
Up to [Pegasus] / pegasus / cgi / htdocs / Attic