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

mi_lo_specset_sbspace()

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

Syntax

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.

Return Values

MI_OK

The function was successful.

MI_ERROR

The function was not successful.

Related Topics

See the descriptions of the following functions: mi_lo_copy(), mi_lo_create(), mi_lo_expand(), mi_lo_from_file(), mi_lo_spec_free(), mi_lo_spec_init(), and mi_lo_specget_sbspace().

In Chapter 3, "Handling Smart Large Objects," see "Storage Characteristics" for more information on the sbspace name of a smart large object. See "The LO-Specification Structure", and "Defining User-Specified Storage Characteristics" for information on how to use the mi_lo_specset_sbspace() function.




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