NAME

WideCharToMultiByte  (KERNEL32.@)

SYNOPSIS

 INT WideCharToMultiByte
 (
  UINT    page,
  DWORD   flags,
  LPCWSTR src,
  INT     srclen,
  LPSTR   dst,
  INT     dstlen,
  LPCSTR  defchar,
  BOOL*   used
 )

DESCRIPTION

Convert a Unicode character string into a multibyte string.

PARAMS

page [In] Code page character set to convert to.
flags [In] Mapping Flags (MB_ constants from "winnls.h").
src [In] Source string buffer.
srclen [In] Length of src, or -1 if src is NUL terminated.
dst [Out] Destination buffer.
dstlen [In] Length of dst, or 0 to compute the required length.
defchar [In] Default character to use for conversion if no exact conversion can be made.
used [Out] Set if default character was used in the conversion.

RETURNS

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

Failure: 0. Use GetLastError to determine the cause. Possible errors are ERROR_INSUFFICIENT_BUFFER, if not enough space is available in dst and dstlen != 0, and ERROR_INVALID_PARAMETER, if an invalid parameter was given.

IMPLEMENTATION

Defined in "heap.h".

Implemented in "dlls/kernel/locale.c". source.winehq.org/source/dlls/kernel/locale.c

Debug channel "nls".


Copyright © 2005 The Wine Project. All trademarks are the property of their respective owners. Visit WineHQ for license details. Generated Aug 2005.