This function will make a physical copy including the
content if it exists and returns the new object or an error
object. The parameter array contains the required elements
'objectIdentifier' and 'destinationParentIdentifier'. The
optional parameter is 'attributeSelector'`
See also hwapi_move(),
hwapi_link().