lld_read()

API

mi_integer lld_read (io, buffer, bytes, error)

LLD_IO*                         io, 
void*                           buffer, 
mi_integer                      bytes, 
mi_integer*                     error);

ESQL/C

int lld_read (LLD_IO* io, 
            void* buffer, int bytes, 
            int* error);

io: is a pointer to an LLD_IO structure created with a previous call to the lld_open() function.
buffer: is a pointer to a buffer into which to read the data. The buffer must be at least as large as the number of bytes specified in the bytes parameter.
bytes: is the number of bytes to read.
error: is an output parameter in which the function returns an error code.

Usage

Before calling this function, you must open the large object with a call to lld_open() and set the LLD_RDONLY or LLD_RDWR flag. The lld_read() function begins reading from the current position. By default, when you open a large object, the current position is the beginning of the object. You can call lld_seek() to change the current position.

Return Codes

On success, the lld_read() function returns the number of bytes that it has read from the large object.

On failure, for an API function, it returns MI_ERROR; for an ESQL/C function, it returns -1.

lld_read()

Syntax

Usage

Return Codes

Context