mi_integer mi_tab_setniorows(MI_AM_TABLE_DESC *tableDesc,
   mi_integer nrows)

tableDesc

points to the table descriptor.

nrows

specifies the maximum number of rows that am_getnext processes.

The access method must call this function before it calls mi_tab_setnextrow(). Multiple calls to mi_tab_setniorows() during the execution of a single statement causes an exception to be raised.

The integer indicates the actual number of rows for which the database server allocates memory. Currently, the return value equals nrows. A zero or negative return value indicates an error.

See the descriptions of functions mi_tab_niorows() and mi_tab_setnextrow().