Sets the data of a binary large object.
Whenever a binary large object has been created using a call to MimerSetLob, it has to be filled with data. This is done using a call to this routine. A call to this routine must always be preceded by a call to MimerSetLob.
The total length of all the chunks supplied by one or more calls to this routine must coincide with the length supplied in the preceding call to MimerSetLob, or else an error will occur.
When the entire binary large object has been set, the handle is automatically released.
Parameters
MimerLob *blobhandle,
const void *data,
size_t size)
|
blobhandle |
in |
A reference to a binary large object handle created by MimerSetLob. |
|
data |
in |
A pointer to the binary large object data. |
|
size |
in |
Size of the chunk supplied in this call, in bytes. The size of each chunk is limited to slightly less than 10 MB. If larger objects than this is to be set, multiple calls to this routine must be used, each supplying the large object in chunks. |
Returns
A negative value indicating an error, or zero if successful.
|
Return value |
Description |
|---|---|
|
MIMER_SUCCESS |
Success. |
|
MIMER_HANDLE_INVALID |
The blobhandle parameter was not recognized as a handle. |
|
MIMER_NULL_VIOLATION |
Cannot assign the null value to a non-nullable parameter |
|
MIMER_OUTOFMEMORY |
If not enough memory could be allocated. |
|
Other value < 0 |
Any of the server error codes listed in Return Codes. |
Notes
This routine interacts with the database server.
Not Micro API compatible.