NAME¶

MultiByteToWideChar (KERNEL32.@)

SYNOPSIS¶

INT MultiByteToWideChar
(
UINT page,
DWORD flags,
LPCSTR src,
INT srclen,
LPWSTR dst,
INT dstlen
)

DESCRIPTION¶

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".