MimerSetNclobData

Sets the data of a character large object. (wchar_t version.)

Whenever a character 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.

When the entire character large object has been set, the handle is automatically released.

Parameters

int32_t MimerSetNclobData (

            MimerLob *clobhandle,

            const wchar_t *data,

            size_t length)

clobhandle

in

A reference to a character large object handle created by MimerSetLob.

data

in

A pointer to the character data.

length

in

Length of the chunk supplied in this call, in characters.

The size of each chunk is limited to slightly less than 10 MB. This translates to, in the worst case, about 2.5 million characters. If larger character objects than this is to be set, multiple calls to this routine must be used, each supplying the character 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 clobhandle parameter was not recognized as a handle.

MIMER_ILLEGAL_CHARACTER

The input string contained illegal characters.

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.

wchar_t version of the routine. See Character String Formats for more information about character formats and the different routine versions.