Win32 C++开发：如何将日文字符的虚拟键/扫描码转回原字符

已获取平假名「つ」对应的虚拟键码、扫描码，需要在不生成实际按键事件、无法依赖WM_CHAR消息的前提下，将键码转换回对应的日文原字符。已知日文键盘布局下，按下Z键默认输出字符「つ」。
现有自行编写的转换代码仅对ASCII字符正常生效，对日文假名转换失败。

异常测试代码 #

HKL hkl = GetKeyboardLayout(0);
BYTE ks[256] = {};
GetKeyboardState(ks);
uint virtualKeyCode = VkKeyScanEx(L'つ', hkl);
uint scanCode = 44;

uint16_t sc = MapVirtualKeyW(virtualKeyCode, MAPVK_VK_TO_VSC_EX);
const uint32_t flags = 1 << 2; // Do not change keyboard state of this thread
static uint8_t state[256] = { 0 };
state[VK_SHIFT] = false << 7; // Modifiers set the high-order bit when pressed

qDebug() << (unsigned int)'つ';
wchar_t unicodeChar;
if (ToUnicode(virtualKeyCode, sc, state, &unicodeChar, 1, flags) == 1)
    qDebug() << QString::fromUtf8(QByteArray(reinterpret_cast<const char*>(&unicodeChar), 2));

unsigned short result = 0;
qDebug() << ToUnicodeEx(virtualKeyCode, scanCode, ks, reinterpret_cast<LPWSTR>(&result), (int)2, (uint)0, hkl);
qDebug() << "TEST" << result;

运行异常输出 #

14909860 // (unsigned int)'つ';
0        // return value of tounicode()
TEST 0   //result

ToUnicode与ToUnicodeEx接口均返回0，无法获取目标日文字符「つ」。

• 日文键盘的假名输入依赖Kana输入模式状态，直接调用ToUnicode/ToUnicodeEx时未激活该模式，接口仅能映射键盘布局直接支持的半角ASCII字符，无法返回假名结果。
• 错误使用VkKeyScanEx做反向查询：该接口用于从字符反查虚拟键码，在Kana模式未激活的状态下，无法正确返回日文假名对应的虚拟键码。
• 键盘状态数组配置错误：未设置VK_KANA的激活状态位，同时传入的1<<2标志会跳过IME相关的状态处理，导致转换逻辑完全走ASCII映射分支。
• 调用接口时未明确指定日文键盘布局句柄，默认取当前线程激活的键盘布局，如果当前激活的是中文/英文布局，自然无法映射日文假名。

核心逻辑：先加载日文键盘布局，手动在键盘状态数组中设置Kana模式激活，再调用ToUnicodeEx完成键码到字符的转换，不需要触发实际按键事件。

#include <windows.h>
#include <stdio.h>

int main()
{
    // 加载日文键盘布局，系统未安装日文输入法时会调用失败
    HKL hklJP = LoadKeyboardLayoutW(L"00000411", KLF_ACTIVATE | KLF_SUBSTITUTE_OK);
    if (!hklJP)
    {
        printf("请先安装日文输入法及日文键盘布局\n");
        return -1;
    }

    BYTE keyState[256] = {0};
    // 关键：设置Kana输入模式为激活状态，键状态数组高位为1表示对应键按下/锁定
    keyState[VK_KANA] = 0x80;
    // 无修饰键按下，Shift/Ctrl/Alt状态保持0即可
    keyState[VK_SHIFT] = 0;
    keyState[VK_CONTROL] = 0;
    keyState[VK_MENU] = 0;

    // 日文键盘下Z键对应「つ」：VK为0x5A（即'Z'），扫描码为44（0x2C）
    UINT targetVK = 'Z';
    UINT targetSC = 44;
    wchar_t outBuf[4] = {0};

    int res = ToUnicodeEx(
        targetVK,
        targetSC,
        keyState,
        outBuf,
        4,
        0, // 不要传入修改线程键盘状态的相关flag
        hklJP
    );

    if (res >= 1)
    {
        wprintf(L"转换结果：%s\n", outBuf); // 正常输出「つ」
    }
    else
    {
        printf("转换失败，返回值：%d\n", res);
    }

    // 用完可卸载加载的键盘布局
    UnloadKeyboardLayout(hklJP);
    return 0;
}

注意事项 #

• 必须确保运行环境已安装日文键盘布局，否则LoadKeyboardLayoutW调用失败，无法完成转换。
• 如果存储的是扩展键扫描码（带0xE0前缀），需要在扫描码值中正确标记扩展位，否则会匹配到错误的物理键。
• 不要依赖VkKeyScanEx查询日文假名对应的虚拟键码，日文Kana布局下物理键和假名的映射是固定的，直接使用物理键对应的VK+SC即可。
• 不要给ToUnicodeEx传入1<<2标志，该标志会阻止接口读取IME相关的状态配置，导致假名转换失效。

内容的提问来源于stack exchange，提问作者Xenius