imm.h) (ImmGetIMEFileNameA 函数

检索与指定输入区域设置关联的 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 字符。

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

注意

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