Advances the current row to the next row, but only within the current array.
If the end of the array is reached, end of data is returned, and a new request must be made to the server for additional rows.
The difference between calling this function and MimerFetch or MimerFetchSkip is that this routine is guaranteed to never make server requests and therefore guaranteed not to require any context switches.
Parameters
int32_t MimerNext (MimerStatement statementhandle)
|
statementhandle |
in |
A handle returned by MimerBeginStatement[C|8], identifying a statement with an open cursor. |
Returns
Returns MIMER_SUCCESS if the row was advanced one row. MIMER_NO_DATA was returned if the end of the array was reached.
|
Return value |
Description |
|---|---|
|
MIMER_NO_DATA |
End of table reached. |
|
MIMER_SUCCESS |
Success. |
|
MIMER_HANDLE_INVALID |
The statementhandle parameter was not recognized as a handle. |
Notes
Not Micro API compatible.