FIX: When you call the WideCharToMultiByte function to enable your application to use the GB18030 data converter in Windows CE 5.0, the return value of the function may be incorrect

In Microsoft Windows CE 5.0, you call the WideCharToMultiByte function to enable your application to use the GB18030 data converter. However, the return value of the function may be incorrect. This problem occurs when the following conditions are true:

• The CodePage parameter of the function is set to 54936.
• The cchWideChar parameter of the function is set to -1.

This problem occurs because the NULL termination character of the string is ignored if the cchWideChar parameter is set to -1.

Software update information

A supported software update is now available from Microsoft as Windows CE 5.0 Platform Builder Monthly Update (September 2008). You can confirm this by scrolling to the "File information" section of this article. The package file name contains the product version, date, Knowledge Base article number, and processor type. The package file name format is:For example: Wincepb50-060503-kb917590-armv4i.msi is the ARMV4i Windows CE 5.0 Platform Builder fix that is documented in KB article 917590 and that is contained in the May 2006 monthly update. To resolve this problem immediately, click the following article number for information about obtaining Windows CE Platform Builder and core operating system software updates:

Prerequisites

This update is supported only if all previously issued updates for this product have also been installed.

Restart requirement

After you apply this software update, you must perform a clean build of the whole platform. To do this, use one of the following methods:

• On the Build OS menu, make sure that the following options are selected, and then click Sysgen:
  • Clean Before Building
  • Copy Files to Release Directory After Build
  • Make Run-Time Image After Build
• On the Build OS menu, click Open Release Directory. Then, at a command prompt, type blddemo clean -q, and then press ENTER.

You do not have to restart the computer after you apply this software update.

Update replacement information

This update does not replace any other updates.

File information

The English version of this software update package has the file attributes or the later file attributes that are listed in the following table.



The English version of this software update package has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

To work around this problem, follow these steps:

1. Calculate the length of the character string. To do this, call the strlen function before you call the WideCharToMultiByte function.
2. Add 1 to the value that you obtained in step 1.
3. Set the sum that you obtained in step 2 as the value of the cchWideChar parameter of WideCharToMultiByte function. Use this value instead of -1.

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

For more information about the GB18030 data converter, visit the following Microsoft Developer Network (MSDN) Web site:For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base: