UniUconvToUcs

Convert a code page string to a UCS string.

Syntax
UniUconvToUcs(uconvObj, inBuffer, inBufferLen, ucsBuffer, ucsBufferLen, nonIdenticalConv)

Parameters

 * uconvObj - UconvObject - input: The conversion object created from UniCreateUconvObject.
 * inBuffer - (void **) - input: The input buffer.
 * inBufferLen - (size_t *) - input/output: The input buffer's length, in bytes.
 * ucsBuffer - UniChar - output: The ucs buffer.
 * ucsBufferLen - (size_t *) - output: Number of Unicode character elements in the ucsBuffer.
 * nonIdenticalConv - (size_t *) - output: Number of non-identical conversions.

Constants
None

Returns
An integer with values of:
 * ULS_INVALID
 * ULS_SUCCESS

UniUconvToUcs updates the variables pointed to by the arguments to reflect the extent of the conversion and returns, in nonidentical, the number of substitutions (non-identical conversions) performed. If the entire string in the input buffer is converted, the value pointed to by inBufferLen will be 0. If the input conversion is stopped due to any condition mentioned above, the value pointed to by inBufferLen will be nonzero and a nonzero value is returned to indicate the condition. If an error occurs, UniUconvToUcs returns a nonzero value.

Calling Convention
Cdecl32

Example Code
UconvObject uconvObj; void**     inBuffer; size_t*    inBufferLen; UniChar    ucsBuffer; size_t*    ucsBufferLen; size_t*    nonIdenticalConv; integer    rc; ... rc = UniUconvToUcs(uconvObj, inBuffer, inBufferLen, ucsBuffer, ucsBufferLen, nonIdenticalConv); ...

Related Functions

 * UniUconvFromUcs
 * UniStrFromUcs
 * UniStrToUcs

OS Version Introduced
OS/2 Warp