The WCopy method

This method copies the wide character string from to the location pointed to by to. If the strings overlap, the result is undefined.

int WCopy(ITWChar *to, const ITWChar *from, 
          int nfromwchars = ITLocale::ScanToNul) const

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

This method returns the number of characters 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.