Name

om_copy - Creates a new private object that is an exact, but independent, copy of an existing private object

Synopsis

#include <xom.h> OM_return_code om_copy(
OM_private_object original,
OM_workspace workspace,
OM_private_object ∗copy);

Parameters

Input

originalThe original that remains accessible. 

workspaceThe workspace in which the copy is to be created.  The original’s class must be in a package associated with this workspace. 

Output

copyThe new copy of the private object.  This result is present if and only if the return value for OM_return_code is OM_SUCCESS. 

Description

The om_copy() function creates a new private object (the copy) that is an exact but independent copy of an existing private object (the original).  The function is recursive in that copying the original also copies its subobjects. 

Return Values

The following describes a partial list of messages (or errors) that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

OM_return_code
Indicates whether the function succeeded and, if not, why not. If the function is successful, the value of OM_return_code is set to OM_SUCCESS; if the function fails, it has one of the error values listed in this reference page.  The exact constants for OM_return_code are defined in the xom.h header file (see the xom.h(4xom) reference page). 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

       •OM_FUNCTION_INTERRUPTED

       •OM_MEMORY_INSUFFICIENT

       •OM_NETWORK_ERROR

       •OM_NO_SUCH_CLASS

       •OM_NO_SUCH_OBJECT

       •OM_NO_SUCH_WORKSPACE

       •OM_NOT_PRIVATE

       •OM_PERMANENT_ERROR

       •OM_POINTER_INVALID

       •OM_SYSTEM_ERROR

       •OM_TEMPORARY_ERROR

       •OM_TOO_MANY_VALUES