Функция GetKeyboardLayoutNameW (winuser.h)

Статья
11/20/2024

Извлекает имя идентификатора языкового стандарта активного ввода (ранее называемого раскладкой клавиатуры) для вызывающего потока.

Синтаксис

BOOL GetKeyboardLayoutNameW(
  [out] LPWSTR pwszKLID
);

Параметры

[out] pwszKLID

Тип: LPTSTR

Буфер (по крайней мере KL_NAMELENGTH символов в длину), который получает имя входного идентификатора языкового стандарта, включая завершающийся символ NULL. Это будет копия строки, предоставленной функции LoadKeyboardLayout, если не произошла подстановка макета.

Список входных макетов, предоставляемых в Windows, см. в разделе Идентификаторы клавиатуры и редакторы методов ввода для Windows.

Возвращаемое значение

Тип: BOOL

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Идентификатор языкового стандарта ввода — это более широкая концепция, чем раскладка клавиатуры, так как она также может охватывать преобразователь речи к тексту, редактор метода ввода (IME) или любую другую форму ввода.

начиная с Windows 8: Предпочтительный метод получения языка, связанного с текущим макетом клавиатуры или методом ввода, является вызовом Windows.Globalization.Language.CurrentInputMethodLanguageTag. Если приложение передает теги языка из CurrentInputMethodLanguageTag в любые функции поддержки национального языка , необходимо сначала преобразовать теги, вызвав ResolveLocaleName.

Заметка

Заголовок winuser.h определяет GetKeyboardLayoutName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll