Add the currently set parameters to the statement be executed on the next call to MimerExecute. If this call succeeds, the statement is ready to accept another set of parameters to be executed during the same server call. The benefit of executing several parameter sets at the same time is beneficial to performance.
Statements which may accept multiple parameter sets include DML statement and procedure calls, such as INSERT, UPDATE, DELETE and CALL. MimerAddBatch cannot be used with statements which return result sets.
Parameters
MimerStatement statementhandle)
|
statementhandle |
in |
The statement whose parameters to batch. |
Returns
A negative value indicating an error, or zero if successful.
|
Return value |
Description |
|---|---|
|
MIMER_SUCCESS |
Success. |
|
MIMER_HANDLE_INVALID |
The statementhandle parameter was not recognized as a handle. |
|
MIMER_SEQUENCE_ERROR |
The statement was not ready to accept parameters. |
|
MIMER_UNSET_PARAMETERS |
All input parameters have not yet been set. |
|
MIMER_OUT_OF_MEMORY |
Enough memory to hold an additional set of parameters could not be allocated. |
Notes
This routine may interact with the database server.
Micro API compatible.