The RasSetEntryPropertiesA function does not support Japanese Shift-JIS characters in Windows 7 or in Windows Server 2008 R2

Applies to: Windows 7 EnterpriseWindows 7 Home BasicWindows 7 Home Premium

Symptoms


You have an application that uses the RasSetEntryPropertiesA function to create dial-up entries. When you run the application on a computer that is running Windows 7 or Windows Server 2008 R2, an error occurs, and the application cannot create the dial-up entry.

This issue occurs when the entry name (lpszEntry parameter) of this function contains Japanese Shift-JIS characters. Specifically, this issue occurs when the SHIFT-JIS string contains one of the following codes:
  • 0x2F
  • 0x2A
  • 0x3A
  • 0x3C
  • 0x3E
  • 0x3F
  • 0x5C
  • 0x7C
Note This issue does not occur if you use the RasSetEntryPropertiesW function.

Cause


This issue occurs because the RasSetEntryPropertiesA function uses CP_UTF8 to convert input string to UTF16 in Windows 7. However, some Shift-JIS characters cannot be encoded by using UTF8, such as "十" (0x8F5C), "ポ" (0x737C), or "芸" (0x8C7C). If the input string contains Shift-JIS characters, the conversion produces an incorrect string, and the function might fail.

Note The same function works correctly in Windows Vista. In Windows Vista, the function uses CP_ACP code page to convert the input string to UTF16.

Resolution


Hotfix information

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem that is described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

To apply this hotfix, you must be running one of the following operating systems:
  • Windows 7
  • Windows 7 Service Pack 1 (SP1)
  • Windows Server 2008 R2
  • Windows Server 2008 R2 Service Pack 1 (SP1)

Registry information

You do not have to make any changes to the registry to use this hotfix.

Restart requirement

You may have to restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace a previously released hotfix.

File information

The global version of this hotfix installs files that have the attributes that are listed in the following tables. The dates and the times for these files are listed in Coordinated Universal Time (UTC). The dates and the times for these files on your local computer are displayed in your local time together with your current daylight saving time (DST) bias. Additionally, the dates and the times may change when you perform certain operations on the files.
Windows 7 and Windows Server 2008 R2 file information notes
Important Windows 7 hotfixes and Windows Server 2008 R2 hotfixes are included in the same packages. However, hotfixes on the Hotfix Request page are listed under both operating systems. To request the hotfix package that applies to one or both operating systems, select the hotfix that is listed under "Windows 7/Windows Server 2008 R2" on the page. Always refer to the "Applies To" section in articles to determine the actual operating system to which each hotfix applies.
  • The files that apply to a specific product, milestone (RTM, SPn), and service branch (LDR, GDR) can be identified by examining the file version numbers as shown in the following table:
    VersionProductMilestoneService branch
    6.1.760
    0.16xxx
    Windows 7 and Windows Server 2008 R2RTMGDR
    6.1.760
    0.20xxx
    Windows 7 and Windows Server 2008 R2RTMLDR
    6.1.760
    1.17xxx
    Windows 7 and Windows Server 2008 R2SP1GDR
    6.1.760
    1.21xxx
    Windows 7 and Windows Server 2008 R2SP1LDR
  • GDR service branches contain only those fixes that are widely released to address widespread, critical issues. LDR service branches contain hotfixes in addition to widely released fixes.
  • The MANIFEST files (.manifest) and the MUM files (.mum) that are installed for each environment are listed separately in the "Additional file information for Windows Server 2008 R2 and for Windows 7" section. MUM and MANIFEST files, and the associated security catalog (.cat) files, are critical to maintaining the state of the updated components. The security catalog files, for which the attributes are not listed, are signed with a Microsoft digital signature.
For all supported x86-based versions of Windows 7
File nameFile versionFile sizeDateTimePlatform
Pbkmigr.dll7.2.7600.2086567,58423-Dec-201014:58x86
Rasapi32.dll6.1.7600.20865325,12023-Dec-201014:58x86
Pbkmigr.dll7.2.7601.1751467,58420-Nov-201012:20x86
Rasapi32.dll6.1.7601.21626325,12023-Dec-201005:25x86
For all supported x64-based versions of Windows 7 and of Windows Server 2008 R2
File nameFile versionFile sizeDateTimePlatform
Pbkmigr.dll7.2.7600.2086557,85623-Dec-201015:40x64
Rasapi32.dll6.1.7600.20865384,51223-Dec-201015:40x64
Pbkmigr.dll7.2.7601.1751457,85620-Nov-201013:27x64
Rasapi32.dll6.1.7601.21626384,51223-Dec-201006:15x64
Pbkmigr.dll7.2.7600.2086567,58423-Dec-201014:58x86
Rasapi32.dll6.1.7600.20865325,12023-Dec-201014:58x86
Pbkmigr.dll7.2.7601.1751467,58420-Nov-201012:20x86
Rasapi32.dll6.1.7601.21626325,12023-Dec-201005:25x86
For all supported IA-64-based versions of Windows Server 2008 R2
File nameFile versionFile sizeDateTimePlatform
Pbkmigr.dll7.2.7600.20865127,48823-Dec-201014:43IA-64
Rasapi32.dll6.1.7600.20865759,29623-Dec-201014:44IA-64
Pbkmigr.dll7.2.7601.21626127,48823-Dec-201006:33IA-64
Rasapi32.dll6.1.7601.21626759,29623-Dec-201006:33IA-64
Pbkmigr.dll7.2.7600.2086567,58423-Dec-201014:58x86
Rasapi32.dll6.1.7600.20865325,12023-Dec-201014:58x86
Pbkmigr.dll7.2.7601.1751467,58420-Nov-201012:20x86
Rasapi32.dll6.1.7601.21626325,12023-Dec-201005:25x86

Status


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

More Information


For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:

824684

Description of the standard terminology that is used to describe Microsoft software updates

Additional file information

Additional file information for Windows 7 and for Windows Server 2008 R2

Additional files for all supported x86-based versions of Windows 7
File nameUpdate.mum
File versionNot applicable
File size2,731
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameX86_188644776bea046250100eb5ef601a13_31bf3856ad364e35_6.1.7601.21626_none_58dad34555c2c1e7.manifest
File versionNot applicable
File size694
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameX86_78c1b552606533fc829634eecee5c285_31bf3856ad364e35_6.1.7600.20865_none_aa8bbfdc3eef7bb9.manifest
File versionNot applicable
File size694
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7600.20865_none_6dad19c8c9e62471.manifest
File versionNot applicable
File size12,815
Date (UTC)23-Dec-2010
Time (UTC)15:30
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7601.21626_none_6fbfb6c8c6eb39f0.manifest
File versionNot applicable
File size13,279
Date (UTC)27-Dec-2010
Time (UTC)18:32
PlatformNot applicable
Additional files for all supported x64-based versions of Windows 7 and of Windows Server 2008 R2
File nameAmd64_092e0689568eda5f75a1f5acb22d2049_31bf3856ad364e35_6.1.7601.21626_none_7c8c7409a968077c.manifest
File versionNot applicable
File size698
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameAmd64_3987b3477aaa021ad7f48c34a5ed5576_31bf3856ad364e35_6.1.7601.21626_none_368598f1fb638e4b.manifest
File versionNot applicable
File size1,036
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameAmd64_e3c4f8b447ddb181bdc9d0ed60601867_31bf3856ad364e35_6.1.7600.20865_none_48d13f16364c377f.manifest
File versionNot applicable
File size698
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameAmd64_ed472a9047b4f905e6ce1b1ba38adad7_31bf3856ad364e35_6.1.7600.20865_none_0400830ae679bf29.manifest
File versionNot applicable
File size1,036
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameAmd64_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7600.20865_none_c9cbb54c824395a7.manifest
File versionNot applicable
File size12,821
Date (UTC)23-Dec-2010
Time (UTC)16:31
PlatformNot applicable
File nameAmd64_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7601.21626_none_cbde524c7f48ab26.manifest
File versionNot applicable
File size13,285
Date (UTC)27-Dec-2010
Time (UTC)18:34
PlatformNot applicable
File nameUpdate.mum
File versionNot applicable
File size2,751
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7600.20865_none_6dad19c8c9e62471.manifest
File versionNot applicable
File size12,815
Date (UTC)23-Dec-2010
Time (UTC)15:30
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7601.21626_none_6fbfb6c8c6eb39f0.manifest
File versionNot applicable
File size13,279
Date (UTC)27-Dec-2010
Time (UTC)18:34
PlatformNot applicable
Additional files for all supported IA-64-based versions of Windows Server 2008 R2
File nameIa64_54457f8bb532b018981602869115b2fb_31bf3856ad364e35_6.1.7601.21626_none_a9b0c40be061f7b3.manifest
File versionNot applicable
File size1,034
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameIa64_d91da9fa75f04386feed4c42ad6f9e78_31bf3856ad364e35_6.1.7600.20865_none_415722e1b371038d.manifest
File versionNot applicable
File size1,034
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameIa64_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7600.20865_none_6daebdbec9e42d6d.manifest
File versionNot applicable
File size12,818
Date (UTC)23-Dec-2010
Time (UTC)16:22
PlatformNot applicable
File nameIa64_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7601.21626_none_6fc15abec6e942ec.manifest
File versionNot applicable
File size12,818
Date (UTC)23-Dec-2010
Time (UTC)06:59
PlatformNot applicable
File nameUpdate.mum
File versionNot applicable
File size1,947
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7600.20865_none_6dad19c8c9e62471.manifest
File versionNot applicable
File size12,815
Date (UTC)23-Dec-2010
Time (UTC)15:30
PlatformNot applicable
File nameX86_microsoft-windows-rasapi_31bf3856ad364e35_6.1.7601.21626_none_6fbfb6c8c6eb39f0.manifest
File versionNot applicable
File size13,279
Date (UTC)27-Dec-2010
Time (UTC)18:29
PlatformNot applicable