Advances to the next row of the result set but optionally skips a number of rows in the result set.
If the routine returns successfully, the current row has been advanced the specified number of rows down the result set. Column data may be retrieved using any of the data output functions.
Parameters
MimerStatement statementhandle,
int32_t count)
|
statementhandle |
in |
A handle returned by MimerBeginStatement[C|8], identifying a statement with an open cursor. |
|
count |
in |
Number of rows to advance the current row down the result set. |
Returns
A negative value indicating an error, or zero if successful. A value of MIMER_NO_DATA indicates that the end of the result has been reached.
|
Return value |
Description |
|---|---|
|
MIMER_SUCCESS |
Success. |
|
MIMER_HANDLE_INVALID |
The statementhandle parameter was not recognized as a handle. |
|
MIMER_NO_DATA |
If there are no more rows in the result set. |
|
MIMER_SEQUENCE_ERROR |
If there is no open result set on this statement. |
|
Other value < 0 |
Any of the server error codes listed in Return Codes. |
Notes
This routine interacts with the database server.
Micro API compatible.