EngWideCharToMultiByte function (winddi.h)

The EngWideCharToMultiByte function converts a wide character string into an ANSI source string using the specified code page.

Syntax

ENGAPI INT EngWideCharToMultiByte(
  [in]            UINT   CodePage,
  [in, optional]  LPWSTR WideCharString,
  [in]            INT    BytesInWideCharString,
  [out, optional] LPSTR  MultiByteString,
  [in]            INT    BytesInMultiByteString
);

Parameters

[in] CodePage

Specifies the code page to use to perform the translation.

[in, optional] WideCharString

Pointer to a buffer containing the wide character string to be translated.

[in] BytesInWideCharString

Specifies the size, in bytes, of WideCharString.

[out, optional] MultiByteString

Pointer to a buffer into which the translated character string is to be copied

[in] BytesInMultiByteString

Specifies the number of bytes in MultiByteString. If MultiByteString is not large enough to contain the translation, EngWideCharToMultiByte truncates the string, and does not report an error.

Return value

EngWideCharToMultiByte returns the number of bytes converted into multibyte form, if successful. Otherwise, it returns -1.

Requirements

See also

EngMultiByteToWideChar

EngUnicodeToMultiByteN