Download Inheritance - The Open Group

Transcript
NAMESPACE
InstanceName - The InstanceName input parameter defines the name of the Instance to be
retrieved.
LocalOnly - If the LocalOnly input parameter is true, this specifies that only elements
(properties and qualifiers) overriden within the definition of the Instance are returned. If
false, 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 PROPAGATED attribute).
IncludeQualifiersIf - the IncludeQualifiers input parameter is true, this specifies
that all Qualifiers for that Instance (including Qualifiers on the Instance and on any returned
Properties) MUST be included as elements in the response. If false no elements are present
in the returned Instance.
IncludeClassOrigin - If the IncludeClassOrigin input parameter is true, this
specifies that the CLASSORIGIN attribute MUST be present on all appropriate elements in
the returned Instance. If false, no CLASSORIGIN attributes are present in the returned
instance.
PropertyList - If the PropertyList input parameter is not NULL, the members of the
array define one or more CIMProperty names. The returned Instance MUST NOT include
elements for any Properties missing from this list. Note that if LocalOnly is specified as true
this acts as an additional filter on the set of Properties returned (for example, if CIMProperty
A is included in the PropertyList but LocalOnly is set to true and A is not local to the
requested Instance, then it will not be included in the response). If the PropertyList input
parameter is an empty array this signifies that no Properties are included in the response. If
the PropertyList input parameter is NULL this specifies that all Properties (subject to the
conditions expressed by the other parameters) are included in the response. If the
PropertyList contains duplicate elements, the Server MUST ignore the duplicates but
otherwise process the request normally. If the PropertyList contains elements which are
invalid CIMProperty names for the target Instance, the Server MUST ignore such entries but
otherwise process the request normally.
Returns:
If successful, the return value is a single CIM Instance. 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.
■ CIM_ERR_ACCESS_DENIED
■ CIM_ERR_INVALID_NAMESPACE
■ CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or
otherwise incorrect parameters)
■ CIM_ERR_INVALID_CLASS (the CIM Class does not exist in the specified
namespace)
■ CIM_ERR_NOT_FOUND (the CIM Class does exist, but the requested CIM Instance
does not exist in the specified namespace)
■ CIM_ERR_FAILED (some other unspecified error occurred)
http://donald/MSB/Manual/CIMOperations.html (6 of 27) [5/5/2001 8:55:31 AM]