uconv_object (UconvObject)

Conversion object created by a call to UniCreateUconvObject.

inbuf

Input buffer.

inbytesleft (size_t *)

Size of inbuf, in units of bytes.

ucsbuf (UniChar **)

Output buffer.

UniCharsleft (size_t *)

Number of UniChar elements in ucsbuf.

nonidentical (size_t *)

Number of nonidentical conversions.

result (int) - returns

UCONV_E2BIG

Input conversion stopped due to lack of space in the output buffer.
UCONV_EBADF
The uconv_object argument is not a valid, open conversion object.
UCONV_EILSEQ
Input conversion stopped due to an input byte that does not belong to the input code page.
UCONV_EINVAL
Input conversion stopped due to an incomplete character or shift sequence at the end of the input buffer.
ULS_SUCCESS
Conversion successful.
UniUconvToUcs updates the variables pointed to by the arguments to reflect the extent of the conversion and returns, in nonidentical, the number of substitutions (nonidentical) conversions performed. If the entire string in the input buffer is converted, the value pointed to by inbytesleft will be zero. If the input conversion is stopped due to any condition mentioned above, the value pointed to by inbytesleft will be non zero and a non zero value is returned to indicate the condition. If an error occurs, UniUconvToUcs returns a non zero value.

For a full list of error codes and the decimal and hexadecimal values of the error codes, see Error Codes.