Функция ImmGetIMEFileNameA (imm.h)
Извлекает имя файла IME, связанного с указанным входным языковым стандартом.
Синтаксис
UINT ImmGetIMEFileNameA(
HKL unnamedParam1,
[out, optional] LPSTR lpszFileName,
[in] UINT uBufLen
);
Параметры
unnamedParam1
[out, optional] lpszFileName
Указатель на буфер, в котором функция извлекает имя файла. Этот параметр содержит значение NULL , если для uBufLen задано значение NULL.
[in] uBufLen
Размер выходного буфера в байтах. Приложение задает значение 0, если функция должна возвращать размер буфера, необходимый для получения имени файла, не включая завершающий символ NULL. Для Юникода uBufLen указывает размер в символах Юникода, не включая завершающий символ NULL.
Возвращаемое значение
Возвращает количество байтов в имени файла, скопированного в выходной буфер. Если приложение устанавливает для uBufLen значение 0, функция возвращает размер буфера, необходимый для имени файла. В любом случае завершающий символ NULL не включается.
Для Юникода функция возвращает количество символов Юникода, скопированных в выходной буфер, не включая завершающий символ NULL в Юникоде.
Комментарии
В реестре операционная система сохраняет имя файла в виде значения "имя IME" в разделе реестра HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.
Примечание
Заголовок imm.h определяет ImmGetIMEFileName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения], установленная поддержка восточноазиатских языков. |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | imm.h (включая Immdev.h, Windows.h) |
| Библиотека | Imm32.lib |
| DLL | Imm32.dll |