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

mi_large_object_copy_opts()

The mi_large_object_copy_opts() 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

The following table summarizes valid values for the parameters for this routine.

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

smgropts

asmgropts

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




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