The ifx_lo_def_create_spec() function

Syntax

mint ifx_lo_def_create_spec(LO_spec)
   ifx_lo_create_spec_t **LO_spec;

LO_spec

A pointer that points to a pointer to a new LO-specification structure that contains initialized fields. For information about the LO-specification structure, see The LO-specification structure.

Usage

The ifx_lo_def_create_spec() function creates and initializes a new LO-specification structure, ifx_lo_create_spec_t. The ifx_lo_def_create_spec() function initializes the new ifx_lo_create_spec_t structure with the appropriate null values and places its address in the LO_spec pointer. At the time the database server stores the large object, the database server interprets the null values to mean that system-specified defaults should be used for the storage characteristics. For more information, see The system-specified storage characteristics.

Because the ifx_lo_def_create_spec() function allocates memory for the ifx_lo_create_spec_t structure, you must call the ifx_lo_spec_free() function to free that memory when you are finished using the structure.

Return codes

0

The function was successful.

<0

The function was not successful and the return value indicates the cause of the failure.