Función EnumSystemLanguageGroupsA (winnls.h)

  • Artículo

Enumera los grupos de idioma instalados o compatibles con un sistema operativo.

Nota Para configuraciones regionales personalizadas, la aplicación debe llamar a EnumSystemLocalesEx en lugar de EnumSystemLanguageGroups.

 

Sintaxis

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

Parámetros

[in] lpLanguageGroupEnumProc

Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumLanguageGroupsProc.

[in] dwFlags

Marcas que especifican los identificadores de grupo de idioma que se van a enumerar. Este parámetro puede tener uno de los siguientes valores.

Valor Significado
LGRPID_INSTALLED
 Enumere solo los identificadores de grupo de idioma instalados.
LGRPID_SUPPORTED
 Enumera todos los identificadores de grupo de idiomas admitidos.

[in] lParam

Valor definido por la aplicación que se va a pasar a la función de devolución de llamada. Este parámetro se puede usar en la comprobación de errores. También se puede usar para garantizar la seguridad de subprocesos en la función de devolución de llamada.

Valor devuelto

Devuelve TRUE si es correcto 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_BADDB. La función no pudo acceder a los datos. Esta situación no debe producirse normalmente y normalmente indica una instalación incorrecta, un problema de disco o similar.
  • 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.

Comentarios

Esta función enumera los grupos de lenguaje pasando identificadores de grupo de idioma, de uno en uno, a la función de devolución de llamada definida por la aplicación especificada. Este proceso continúa hasta que se encuentra el último identificador de grupo de idioma o la función de devolución de llamada devuelve FALSE.

Nota

El encabezado winnls.h define EnumSystemLanguageGroups 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winnls.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales