MultiByteToWideChar3w

Usage

Overview

Convert a multibyte character string into a Unicode string.

Params

page [In] Codepage character set to convert from.

flags [In] Character mapping flags.

src [In] Source string buffer.

srclen [In] Length of src (in bytes), or -1 if src is NUL terminated.

dst [Out] Destination buffer.

dstlen [In] Length of dst (in WCHARs), or 0 to compute the required length.

Returns

Success: If dstlen > 0, the number of characters written to dst. If dstlen == 0, the number of characters needed to perform the conversion. In both cases the count includes the terminating NUL.

Failure: 0. Use GetLastError(3w) to determine the cause. Possible errors are ERROR_INSUFFICIENT_BUFFER, if not enough space is available in dst and dstlen != 0; ERROR_INVALID_PARAMETER, if an invalid parameter is passed, and ERROR_NO_UNICODE_TRANSLATION if no translation is possible for src.

Implementation

Declared in "winnls.h".

Implemented in "dlls/kernel32/locale.c".

Debug channel "nls".