The WNConcatenate method

This method appends wide character string from to the end of wide character string to. If from and to overlap, the results of this method are undefined.

int WNConcatenate(ITWChar *to, const ITWChar *from, 
            int limit, 
            int nfromwchars = ITLocale::ScanToNul,
            int ntowchars = 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 ntowchars and nfromwchars parameters specify the length of the to and from strings. You can provide an integer to specify the number of characters in the corresponding string. Or you can use the constant ITLocale::ScanToNul (the default) to specify that the corresponding string is null-terminated.

This method returns the number of wide characters in the resulting concatenated string, not including the null terminator, if there is one.

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