The WNCopy method

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

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

Use limit to specify the maximum number of characters to read from the from string and append to the to string.

The nfromwchars parameter specifies the length 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 from is a null-terminated string.

This method returns the number of wide characters copied.

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