Función GetKeyboardLayoutList (winuser.h)

Recupera los identificadores de configuración regional de entrada (antes denominados identificadores de distribución del teclado) correspondientes al conjunto actual de configuraciones regionales de entrada del sistema. La función copia los identificadores en el búfer especificado.

Sintaxis

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

Parámetros

[in] nBuff

Tipo: int

Número máximo de identificadores que puede contener el búfer.

[out] lpList

Tipo: HKL*

Puntero al búfer que recibe la matriz de identificadores de configuración regional de entrada.

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, el valor devuelto es el número de identificadores de configuración regional de entrada copiados en el búfer o, si nBuff es cero, el valor devuelto es el tamaño, en los elementos de la matriz, del búfer necesario para recibir todos los identificadores de configuración regional de entrada actuales.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El identificador de configuración regional de entrada es un concepto más amplio que un diseño de teclado, ya que también puede abarcar un convertidor de voz a texto, un Editor de métodos de entrada (IME) o cualquier otra forma de entrada.

A partir de Windows 8: El método preferido para recuperar el idioma asociado con el diseño de teclado o el método de entrada actual es una llamada a Windows.Globalization.Language.CurrentInputMethodLanguageTag. Si la aplicación pasa etiquetas de idioma de CurrentInputMethodLanguageTag a cualquier función de soporte técnico de idioma nacional , primero debe convertir las etiquetas llamando a ResolveLocaleName.

Requisitos

Consulte también

Conceptual

GetKeyboardLayout

Entrada de teclado

Referencia