|Oracle Call Interface Programmer's Guide
Release 2 (9.2)
Part Number A96584-01
OCI Navigational and Type Functions, 16 of 36
Copies a source instance to a destination.
sword OCIObjectCopy ( OCIEnv *env, OCIError *err, CONST OCISvcCtx *svc, dvoid *source, dvoid *null_source, dvoid *target, dvoid *null_target, OCIType *tdo, OCIDuration duration, ub1 option );
The OCI error handle. If there is an error, it is recorded in
err and this function returns OCI_ERROR. Obtain diagnostic information by calling
An OCI service context handle, specifying the service context on which the copy operation is taking place
A pointer to the source instance; if it is an object, it must be pinned.
Pointer to the null structure of the source object.
A pointer to the target instance; if it is an object is must be pinned.
A pointer to the null structure of the target object.
The TDO for both the source and the target. Can be retrieved with
Allocation duration of the target memory.
This parameter is currently unused. Pass as zero or OCI_DEFAULT.
This function copies the contents of the
source instance to the
target instance. This function performs a deep-copy such that all of the following is copied:
Memory is allocated with the duration specified in the
Certain data items are not copied:
optionparameter, then all references in the source are not copied. Instead, the references in the target are set to null.
OCIObjectFlush()is called. Before the target object is flushed, both the source and the target locators refer to the same LOB value.
The target or the containing instance of the target must be already have been created. This may be done with
OCIObjectPin() depending on whether or not the target object already exists.
target instances must be of the same type. If the source and target are located in a different databases, then the same type must exist in both databases.