Syntax

#include "milo.h"

...
mi_integer mi_lo_specget_maxbytes(LO_spec, maxbytes)

		MI_LO_SPEC *LO_spec;

		mi_int8 *maxbytes; 


LO_spec
is a pointer to the LO-specification structure from which to obtain the maximum size.

maxbytes
is a pointer to an 8-byte integer (mi_int8) value into which mi_lo_specget_maxbytes() puts the maximum size, in bytes, of the smart large object.





 



Valid in Client Application?

Valid in Server Routine?

Yes
Yes

Important: Before you call mi_lo_specget_maxbytes(), you must put storage characteristics into an LO-specification structure.

You can use any of the following to initialize the LO-specification structure:

• The mi_lo_colinfo_by_ids() or mi_lo_colinfo_by_name() function put storage characteristics that are associated with a particular CLOB or BLOB column in an LO-specification structure.
• The mi_lo_stat_cspec() function puts storage characteristics of an existing smart large object in an LO-specification.
• The mi_lo_specset_maxbytes() function sets the maximum size in an LO-specification structure.

Return Values

MI_OK	The function was successful.
MI_ERROR	The function was not successful; the LO-specification structure might be invalid.

In Chapter 3, "Handling Smart Large Objects," see "Storage Characteristics" for more information on the maximum size 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_specget_maxbytes() function.