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 only legal value for this argument is MI_LO_DEFAULT_SMGR.
asmgr
is the archive storage manager for the smart large object. Current legal values are MI_LO_DEFAULT_SMGR, MI_LO_NOSMGR, and NULL. Currently, no difference exists among these values.
currently must be NULL.
smgropts
asmgropts
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_opts() function is identical to mi_large_object_copy(). 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(), mi_large_object_create(), and mi_value().