DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_lo_tell()

The mi_lo_tell() function returns the current LO seek position for an open smart large object.

Syntax

#include "milo.h"

...
mi_integer mi_lo_tell(conn, LO_fd, seek_pos)

		MI_CONNECTION *conn;

		MI_LO_FD LO_fd;

		mi_int8 *seek_pos; 


conn
is a pointer to the connection descriptor that a previous call to mi_open() or mi_server_connect() established.

LO_fd
is an LO file descriptor for the open smart large object whose LO seek position you want to determine.

seek_pos
is a pointer to the 8-byte integer (mi_int8) that identifies the current LO seek position.







 



Valid in Client Application?

Valid in Server Routine?

Yes
Yes

Usage

The LO seek position is the offset for the next read or write operation on the smart large object that is associated with the LO file descriptor, LO_fd. The mi_lo_tell() function returns this seek position in the mi_int8 variable, seek_pos.

Tip: The mi_lo_tell() function replaces the mi_large_object_tell() function, which Informix supports for backward compatibility only. Use mi_lo_tell() for all new DataBlade routines.

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful.

In Chapter 3, "Handling Smart Large Objects," see "Opening a Smart Large Object", "Writing Data to a Smart Large Object", and "Reading Data from a Smart Large Object".

DataBlade API Programmer's ManualChapter 12: DataBlade API Function Descriptions Home Contents Index Master Index New Book

mi_lo_tell()

Syntax

Usage

Return Values MI_OK The function was successful. MI_ERROR The function was not successful.

Related Topics

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

Return Values

MI_OK
The function was successful.

MI_ERROR
The function was not successful.