Retrieves the parents of an object. The parents
can be further filtered by specifying an object query. The
parameter array contains the required elements
'objectidentifier' and the optional elements
'attributeselector' and 'objectquery'.
The return value is an array of objects of type
HW_API_Object
or
HW_API_Error
.
See also
hwapi_children()
.