Функция ImmGetIMEFileNameA (imm.h)

Статья
11/20/2024

Извлекает имя файла 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	imm.h (include Immdev.h, Windows.h)
библиотеки	Imm32.lib
DLL	Imm32.dll

См. также

диспетчера методов ввода

Функции диспетчера методов ввода

Поделиться через