The mi_lo_specset_sbspace() function

The mi_lo_specset_sbspace() function sets the sbspace name of a smart large object in an LO-specification structure.

Syntax

mi_integer mi_lo_specset_sbspace(LO_spec, sbspace_name)
   MI_LO_SPEC *LO_spec;
   const char *sbspace_name;
LO_spec
A pointer to the LO-specification structure in which to save the sbspace name.
sbspace_name
A pointer to the sbspace name for the smart large object.
Valid in client LIBMI application? Valid in user-defined routine?
Yes Yes

Usage

The mi_lo_specset_sbspace() function is the LO-specification accessor function that sets the sbspace name for a new smart large object. The name of the sbspace can be at most 18 characters long and must be null terminated.
Important: Before you call mi_lo_specset_sbspace(), you must initialize an LO-specification structure.

When you set the sbspace name with mi_lo_specset_sbspace(), you override any column-level or system-specified sbspace name in the LO-specification structure. You then pass this LO-specification structure to a smart-large-object creation function (such as mi_lo_create()) to provide the sbspace name as a user-supplied storage characteristic for a new smart large object.

For more information about the sbspace name of a smart large object or on how to use the mi_lo_specset_sbspace() function, see the Informix® DataBlade® API Programmer's Guide.

Return values

MI_OK
The function was successful.
MI_ERROR
The function was not successful.