The MToWString method

This method converts the multibyte character string from to its wide character representation and stores the result in to.

int MToWString(ITWChar *to, const char *from, int limit, 
            int nfrombytes = ITLocale::ScanToNul) const

Use limit to specify the maximum number of bytes to read from the from string and write to to.

The nfrombytes parameter specifies the length of the corresponding multibyte string from. You can provide an integer to specify the number of bytes in from. Or you can use the constant ITLocale::ScanToNul (the default) to specify that from is a null-terminated string.

This method returns number of characters read from from and written to to, not counting the null terminator, if there is one.

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