Reference Names CIM Operation

RETURN

If successful, the method returns the names of zero or more full CIM Class paths or Instance paths of Objects meeting the requested criteria. Since it is possible for CIM Objects from different hosts or namespaces to be associated, each returned path is an absolute path that includes host and namespace information.

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_NOT_SUPPORTED
CIM_ERR_INVALID_NAMESPACE
CIM_ERR_INVALID_PARAMETER (including missing, duplicate, unrecognized or otherwise incorrect parameters)
CIM_ERR_FAILED (some other unspecified error occurred)

Additional Information

NameSpace The NameSpace parameter is a string that defines the target namespace.

ObjectName The objectName input parameter defines the target CIM Object whose referring object names are to be returned. It may be either a Class name or an Instance name (model path).

ResultClass - The resultClass input parameter, if not NULL, MUST be a valid CIM Class name. It acts as a filter on the returned set of Object Names by mandating that each returned Object CIMName MUST identify an Instance of this Class (or one of its subclasses), or this Class (or one of its subclasses).

Role - The role input parameter, if not NULL, MUST be a valid CIMProperty name. It acts as a filter on the returned set of Object Names by mandating that each returned Object CIMName MUST identify an Object that refers to the target Instance via a CIMProperty whose name matches the value of this parameter.

C++ Call

virtual Array<CIMReference> referenceNames(
		const String& nameSpace,
		const CIMReference& objectName,
		const String& resultClass = String::EMPTY,
		const String& role = String::EMPTY) = 0;

Go To Top

Demonstration Prepared by the OpenGroup Manageability Work Group Pegasus Development Team

See (http://www.opengroup.org/management) for more information on Pegasus