The MCopy method

This method copies the multibyte character string from to the location pointed to by to. If from and to overlap, the results of the method are undefined.

int MCopy(char *to, const char *from, 
      int nfrombytes = ITLocale::ScanToNul) const

The nfrombytes parameter specifies the length of the corresponding 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 the number of bytes in the resulting string, not including 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.