Locale independent conversion from wide character string to UTF8 multibyte character string.
A NULL value for pDst results in pDstSize assigned the required size of pDst for the conversion. The resulting wide character string is NULL terminated.
- Parameters
-
pDst | [ out ] Pointer to a buffer to write converted UTF8 character string. If this paramter is NULL the function will return the required buffer size. |
pDstSize | [ in ] The size of the buffer pointed to by pDst (in bytes). [ out ] The number of bytes in pDst that make up the UTF8 string. |
pWs | [ in ] Pointer to the wide character string to convert. |
cCount | [ in ] Max number of characters in pWs to convert to UTF8 |
- Returns
Success | P6R::eOk | |
Failure | P6R::eFail | Unable to convert wide character string into a UTF8 character string. |
P6R::eInvalidArg | If pWs or pDstSize is equal to NULL. |
P6R::eTooSmall | The buffer pointed to by pDst is not big enough. pDstSize points to the required buffer size. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |