immdev.h) (ImmGetDescriptionA 函数

将 IME 的说明复制到指定的缓冲区。

语法

UINT ImmGetDescriptionA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszDescription,
  [in]            UINT  uBufLen
);

unnamedParam1

[out, optional] lpszDescription

指向缓冲区的指针，函数在该缓冲区中检索描述 IME 的以 null 结尾的字符串。

[in] uBufLen

输出缓冲区的大小（以字符为单位）。如果函数要返回完整说明所需的缓冲区大小（不包括终止 null 字符），则应用程序将此参数设置为 0。

Windows NT、Windows 2000、Windows XP： 缓冲区的大小以 Unicode 字符为单位，每个字符由两个字节组成。如果参数设置为 0，则该函数将返回所需的缓冲区大小（以 Unicode 字符为单位），不包括 Unicode 终止 null 字符。

返回复制到输出缓冲区的字符数。如果应用程序将 uBufLen 参数设置为 0，则函数将返回接收说明所需的缓冲区大小。两个值都不包含终止 null 字符。对于 Unicode，该函数返回 Unicode 字符数，不包括 Unicode 终止 null 字符。

注意

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


最低受支持的客户端	Windows XP [仅限桌面应用]，已安装东亚语言支持，已安装东亚语言支持。
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	immdev.h (包括 Immdev.h、Windows.h)
Library	Imm32.lib
DLL	Imm32.dll