The ConvertCodeset method

This method converts the string of multibyte characters in from to another code set and copies the result to the location pointed to by to.

Important: This method assumes that from points to a null-terminated string.

int ConvertCodeset(char *to, const char *from,
                  const char *toLocaleName, 
                  const char *fromLocaleName) const

Use the fromLocalName parameter to identify the locale from which you are converting. Use the toLocalName parameter to specify the locale to which you are converting. There is a single code set associated with each locale. By identifying the locale, you also specify the code set.

If there is an error, this method returns -1. Call ITLocale::GetError() to retrieve a specific error message.

However, there are significant differences between the parameters of the GLS API function ifx_gl_cv_mconv() and the ITLocale method. For example, the GLS API function has specific code set parameters, whereas ITLocale::ConvertCodeset has locale name parameters that imply the code set name. Also, the GLS API function has additional parameters for copying fragments of strings that are unavailable to ConvertCodeset.