Safe copy of a wide-character string Copy as many characters as possible from pWs2 to the start of the string pointed to by pWs1.
If pWs1 is large enough then entire string pointed to by pWs2 will be copied into pWs1, otherwise it will be truncated. pWs1 is always NULL terminated. pWs1 is not zero-filled except for the NULL terminator.
- Parameters
-
pWs1 | [ out ] Pointer to destination string. |
pWs2 | [ in ] Pointer to string to copy onto pWs1. |
size | [ in ] Number of wide-characters in the buffer pointed to by pWs1. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eTooBig | If the string pointed to by pWs2 is too long to fit into pWs1. The result is a truncted value in pWs1. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |