INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_large_object_copy()

The mi_large_object_copy() function copies a smart large object (the source object) to the specified storage manager and creates a new object (the destination object) in the storage manager.

Syntax

Argument Values Used with BLOB

conn

current connection descriptor

LO_handle

handle for the object being copied

filename

NULL

flags

MI_LO_INTERNAL_LO

mode

NULL

smgs

MI_LO_DEFAULT_SMGR

asmgr

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().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.