SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE CloneObjectHandle
extern SE_Return_Code
SE_CloneObjectHandle
(
SE_Object  original_object,1
SE_Object  *duplicate_object2
);

Definition

Clones an object by allocating a new SE_Object and copying the given object into the new SE_Object. Unlike SE_GetNextObject(), this function always allocates a brand-new object for the *duplicate_object being returned.


Returns

SE_RETCOD_SUCCESS and the requested object is cloned, if valid parameters were passed in and all operations succeeded.
SE_RETCOD_FAILURE and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:

SE_STATCODE_SUCCESS set if operation successfully completed.

SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:

SE_STATCODE_INACTIONABLE_FAILURE set if the call failed for any reason.

Parameters Notes

1 object that is being cloned.

2 the clone.


Prev: SE_AllocDataTableData. Next: SE_CloseTransmittal. Up:Index.