ImmGetIMEFileNameA 函数（immdev.h）

检索与指定输入区域设置关联的 IME 的文件名。

语法

UINT ImmGetIMEFileNameA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszFileName,
  [in]            UINT  uBufLen
);

unnamedParam1

[out, optional] lpszFileName

指向函数检索文件名的缓冲区的指针。当 uBufLen 设置为 NULL时，此参数包含 NULL。

[in] uBufLen

输出缓冲区的大小（以字节为单位）。如果函数返回接收文件名所需的缓冲区大小（不包括终止 null 字符），则应用程序指定 0。对于 Unicode，uBufLen 指定 Unicode 字符的大小，不包括终止 null 字符。

返回复制到输出缓冲区的文件名中的字节数。如果应用程序 uBufLen 设置为 0，则函数将返回文件名所需的缓冲区大小。在任一情况下，都不包括终止 null 字符。

对于 Unicode，该函数返回复制到输出缓冲区中的 Unicode 字符数，不包括 Unicode 终止 null 字符。

在注册表中，操作系统将文件名存储为注册表项中的“IME 名称值”HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL。

注意

immdev.h 标头将 ImmGetIMEFileName 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。