Función EnumUILanguagesA (winnls.h)

Artículo
11/20/2024

Enumera los idiomas de la interfaz de usuario que están disponibles en el sistema operativo y llama a la función de devolución de llamada con cada idioma de la lista.

Sintaxis

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

Parámetros

[in] lpUILanguageEnumProc

Puntero a una función de devolución de llamada EnumUILanguagesProc definida por la aplicación. EnumUILanguages llama a esta función repetidamente para enumerar los idiomas de la lista.

[in] dwFlags

Marcas que identifican el formato de idioma y el filtrado. Las marcas siguientes especifican el formato del idioma que se va a pasar a la función de devolución de llamada. Las marcas de formato son mutuamente excluyentes y MUI_LANGUAGE_ID es el valor predeterminado.

Valor	Significado
MUI_LANGUAGE_ID	Pase el identificador de idioma en la cadena de idioma a la función de devolución de llamada.
MUI_LANGUAGE_NAME	Pase el nombre del idioma en la cadena de idioma a la función de devolución de llamada.

Las marcas siguientes especifican el filtrado de la función que se va a usar en la enumeración de los lenguajes. Las marcas de filtrado se excluyen mutuamente y el valor predeterminado es MUI_LICENSED_LANGUAGES.

Valor	Significado
MUI_ALL_INSTALLED_LANGUAGES	Enumerar todos los idiomas instalados disponibles para el sistema operativo.
MUI_LICENSED_LANGUAGES	Enumerar todos los idiomas instalados que están disponibles y con licencia para su uso.
MUI_GROUP_POLICY	Enumerar todos los idiomas instalados que están disponibles y con licencia, y que están permitidos por la directiva de grupo.

Windows Vista y versiones posteriores: La aplicación puede establecer dwFlags en 0 o en una o varias de las marcas especificadas. Un valor de 0 hace que el valor del parámetro se MUI_LANGUAGE_ID de forma predeterminada | MUI_LICENSED_LANGUAGES.

Windows 2000, Windows XP, Windows Server 2003: La aplicación debe establecer dwFlags en 0.

[in] lParam

Valor definido por la aplicación.

Valor devuelto

Devuelve TRUE si se realiza correctamente o FALSE de lo contrario. Para obtener información de error extendida, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

ERROR_INVALID_FLAGS. Los valores proporcionados para las marcas no eran válidos.
ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Observaciones

Esta función enumera los idiomas de la interfaz de usuario que están disponibles y, dependiendo de la marca especificada, con licencia para su uso en el sistema operativo. Pasa identificadores de idioma o nombres de idioma, de uno en uno, a la función de devolución de llamada EnumUILanguagesProc. La función EnumUILanguages continúa pasando identificadores de idioma o nombres a la función de devolución de llamada hasta que se encuentre el último idioma o la función de devolución de llamada devuelva FALSE.

En el caso de las aplicaciones que se ejecutan solo en Windows Vista y versiones posteriores, se recomienda MUI_LANGUAGE_NAME a través de MUI_LANGUAGE_ID. MUI_LANGUAGE_NAME permite la diferenciación entre los idiomas asociados a una configuración regional complementaria de .

Si se especifica la marca MUI_LANGUAGE_ID en la llamada a esta función, las cadenas pasadas a la devolución de llamada

function será identificadores de lenguaje hexadecimal que no incluyen el 0x inicial y será 4.

caracteres de longitud. Por ejemplo, en-US se pasarán como "0409" y en como "0009". El valor "1000" se pasa a la función de devolución de llamada para cualquier lenguaje asociado a una configuración regional complementaria. Este valor corresponde al valor hexadecimal de LOCALE_CUSTOM_UNSPECIFIED. No distingue entre configuraciones regionales complementarias, incluso si el idioma seleccionado está en la lista de idiomas de interfaz de usuario preferidos por el usuario o en la lista de idiomas de interfaz de usuario preferidos del sistema.

firma de C# de

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

Nota

El encabezado winnls.h define EnumUILanguages como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
servidor mínimo admitido	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	winnls.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

EnumUILanguagesProc

GetSystemDefaultUILanguage

GetUserDefaultUILanguage

de interfaz de usuario multilingüe de

funciones de interfaz de usuario multilingües

Compartir a través de