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.