conn
is a pointer to the connection descriptor that a previous call to mi_open() or mi_server_connect() has established.
LO_handle
is a pointer to the handle for the source object. An MI_LOHANDLE value is returned by any routine that creates a smart large object or in query results returned by mi_value().
filename
must be NULL.
flags
indicates the type of smart large object being created. Currently must be set to MI_LO_INTERNAL_LO.
mode
smgr
is the storage manager used to copy the object. Currently, the value for this argument must be MI_LO_DEFAULT_SMGR.
asmgr
is the archive storage manager for the smart large object. Currently, the values must be MI_LO_DEFAULT_SMGR, MI_LO_NOSMGR, or NULL. Currently, no difference exists among these values.
Currently must be NULL.
The following table summarizes valid values for the parameters for this routine.
current connection descriptor
handle for the object being copied
NULL
MI_LO_INTERNAL_LO
smgs
MI_LO_DEFAULT_SMGR
MI_LO_DEFAULT_SMGR or MI_LO_NOSMGR
Usage You can use this function with either BLOB or CLOB objects. The mi_large_object_copy() function is identical to mi_large_object_copy_opts(). Use mi_free() to free this handle when it is no longer needed. Return Values On success, returns a handle for the newly created object; on failure, returns NULL. Related Topics See the descriptions of the following functions: mi_large_object_copy_opts(), mi_large_object_create(), and mi_value().