MultiByteToWideChar.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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

Defined in "winnls.h".

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

Debug channel "nls".