Return to EnumerateInstanceNames.html CVS log | Up to [Pegasus] / pegasus / cgi / htdocs |
File: [Pegasus] / pegasus / cgi / htdocs / Attic / EnumerateInstanceNames.html
(download)
/
(as text)
Revision: 1.5, Tue Mar 27 17:55:17 2001 UTC (23 years, 3 months ago) by karl Branch: MAIN CVS Tags: version_0_97_3, version_0_97_2, version_0_97_1, version_0_97, version_0_96, version_0_95, stable_0_95, stable Changes since 1.4: +21 -15 lines add frames and new functions |
<html> <body bgcolor="#CCCCCC"> <table width="100%"> <tr> <td width="481" align="bottom"><h1>Enumerate Instance Names CIM Operation</h1><td width="2"> <td width="265" align="right"> <img border=1 src="/pegasus/icons/OpenGroupLogo.gif" align="right"> </td> </tr> </table> <hr> <form METHOD=GET ACTION="/pegasus/cgi-bin/CGIClient"> <INPUT TYPE="hidden" NAME="Operation" VALUE="EnumerateInstanceNames"> <p> <a name="TOP"></a> The <TT>enumerateInstances</TT> method enumerates instances of a CIM Class in the target Namespace. <p><b><a href="#NameSpace">NameSpace</a></b> <INPUT TYPE="text" NAME="NameSpace" SIZE=30 VALUE="root/cimv20"> String that defines the target namespace. See <a href="getnamespaces.html">NameSpace Operations</a> for more information. <p><b><a href="#ClassName">ClassName</a></b> <INPUT TYPE="text" NAME="ClassName" SIZE=30> Defines name of the Class for which instance names are to be retrieved. This must be a legal class in the repository <p><b>LocalOnly</b> <INPUT TYPE="checkbox" NAME="LocalOnly" VALUE="true" checked> If true only CIM Elements overridden within definition of class are returned. <p><b>IncludeQualifiers</b> <INPUT TYPE="checkbox" NAME="IncludeQualifiers" VALUE="true"> If checked, show Qualifiers for class and returned Properties, Methods, and Method Parameters. <p><b>IncludeClassOrigins</b> <INPUT TYPE="checkbox" NAME="IncludeClassOrigins" VALUE="true"> If checked (TRUE), CLASSORIGIN attribute will be returned for all appropriate elements<p><b>PropertyList </b> <INPUT TYPE="text" NAME="PropertyList" SIZE=30 VALUE="NULL"> NOTE: <b> NOT IMPLEMENTED </b>Null or array of property names to filter request. <a href="#PropertyList">See below</a>. <p><INPUT TYPE="submit" VALUE="Submit Request"> <INPUT TYPE="reset" VALUE="Reset"> </form> <hr> <h2>RETURN Results</h2> If successful, the method returns zero or more named Instances that meet the required criteria. 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</h2> <p><b><a name="NameSpace">NameSpace</a></b> The NameSpace parameter is a string that defines the target namespace. <p><b><a name="ClassName"> ClassName</a></b> The ClassName input parameter defines the Class that is the basis for the enumeration. The ClassName input must be in the repository <p><a name="LocalOnly"><b> LocalOnly</b></a> If the <TT>LocalOnly</TT> input parameter is <TT>true</TT>, this specifies that, for each returned Instance, only elements (properties and qualifiers) overridden within the definition of that Instance are included. If <TT>false</TT>, all elements are returned. This parameter therefore effects a CIM Server-side mechanism to filter certain elements of the returned object based on whether or not they have been propagated from the parent Class (as defined by the <TT>PROPAGATED</TT> attribute). <p><a name="DeepInheritance"><b>DeepInheritance</b></a> If the <TT>DeepInheritance</TT> input parameter is <TT>true</TT>, this specifies that, for each returned Instance of the Class, all properties of the Instance MUST be present (subject to constraints imposed by the other parameters), including any which were added by subclassing the specified Class. If <TT>false</TT>, each returned Instance includes only properties defined for the specified Class. <p><a name="IncludeQualifiers"><b>IncludeQualifiers</b></a> If the <TT>IncludeQualifiers</TT> input parameter is <TT>true</TT>, this specifies that all Qualifiers for each Instance (including Qualifiers on the Instance and on any returned Properties) MUST be included as <TT>QUALIFIER</TT> elements in the response. If false no <TT>QUALIFIER</TT> elements are present in each returned Instance. <p><b><a name="IncludeClassOrigin">IncludeClassOrigin</a></b> If the <TT>IncludeClassOrigin</TT> input parameter is <TT>true</TT>, this specifies that the <TT>CLASSORIGIN</TTT> attribute MUST be present on all appropriate elements in each returned Instance. If false, no <TT>CLASSORIGIN</TT> attributes are present in each returned Instance.</tt> <p>PropertyList If the <TT>PropertyList</TT> input parameter is not <TT>NULL</TT>, the members of the array define one or more Property names. Each returned Instance MUST NOT include elements for any Properties missing from this list. Note that if <TT>LocalOnly</TT> is specified as <TT>true</TT> (or <TT>DeepInheritance</TT> is specified as <TT>false</TT>) this acts as an additional filter on the set of Properties returned (for example, if Property <TT>A</TT> is included in the <TT>PropertyList</TT> but <TT>LocalOnly</TT> is set to true and <TT>A</TT> is not local to a returned Instance, then it will not be included in that Instance). If the <TT>PropertyList</TT> input parameter is an empty array this signifies that no Properties are included in each returned Instance. If the <TT>PropertyList</TT> input parameter is NULL this specifies that all Properties (subject to the conditions expressed by the other parameters) are included in each returned Instance. If the <TT>PropertyList</TT> contains duplicate elements, the Server MUST ignore the duplicates but otherwise process the request normally. If the <TT>PropertyList</TT> contains elements which are invalid Property names for any target Instance, the Server MUST ignore such entries but otherwise process the request normally. <p><a href="#TOP">Go To Top</a> <hr> <h2>C++ Call</h2> <PRE> virtual Array<InstanceDecl> enumerateInstances( const String& nameSpace, const String& className, Boolean deepInheritance = true, Boolean localOnly = true, Boolean includeQualifiers = false, Boolean includeClassOrigin = false, const Array<String>& propertyList = _getStringArray()) = 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 -->Monday, March 26, 2001 05:01:59 PM<!--webbot bot="Timestamp" i-CheckSum="50769" endspan --> Copyright @ The Open Group 2001 </font> <PRE> </PRE> </body> </html>
No CVS admin address has been configured |
Powered by ViewCVS 0.9.2 |