Compartir a través de

Función EnumSystemLanguageGroupsA (winnls.h)

  • Artículo

Enumera los grupos de idioma que se instalan en o son 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
 Enumerar solo los identificadores de grupo de idioma instalados.
LGRPID_SUPPORTED
 Enumera todos los identificadores de grupo de idioma 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 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_BADDB. La función no pudo acceder a los datos. Esta situación no debería 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.

Observaciones

Esta función enumera los grupos de lenguaje pasando identificadores de grupo de idioma, uno a 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 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 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
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

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales