Función EnumSystemLocalesA (winnls.h)

Enumera las configuraciones regionales que se instalan en o son compatibles con un sistema operativo.

Nota Por motivos de interoperabilidad, la aplicación debe preferir la función EnumSystemLocalesEx para EnumSystemLocales porque Microsoft está migrando hacia el uso de nombres de configuración regional en lugar de identificadores de configuración regional para nuevas configuraciones regionales. Cualquier aplicación que se ejecute solo en Windows Vista y versiones posteriores debe usar EnumSystemLocalesEx.

 

Sintaxis

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Parámetros

[in] lpLocaleEnumProc

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

[in] dwFlags

Marcas que especifican los identificadores de configuración regional que se van a enumerar. Las marcas se pueden usar de forma singly o combinadas mediante un OR binario. Si la aplicación especifica 0 para este parámetro, la función se comporta como para LCID_SUPPORTED.

Valor	Significado
LCID_INSTALLED	Enumerar solo los identificadores de configuración regional instalados. Este valor no se puede usar con LCID_SUPPORTED.
LCID_SUPPORTED	Enumera todos los identificadores de configuración regional admitidos. Este valor no se puede usar con LCID_INSTALLED.
LCID_ALTERNATE_SORTS	Enumera solo los identificadores de configuración regional de ordenación alternativos. Si este valor se usa con LCID_INSTALLED o LCID_SUPPORTED, se recuperan las configuraciones regionales instaladas o admitidas, así como los identificadores de configuración regional de ordenación alternativos.

Valor devuelto

Devuelve un valor distinto de cero si se ejecuta correctamente o 0 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

La función enumera las configuraciones regionales pasando identificadores de configuración regional, de uno en uno, a la función de devolución de llamada definida por la aplicación especificada. Esto continúa hasta que se hayan pasado todos los identificadores de configuración regional instalados o admitidos a la función de devolución de llamada o la función de devolución de llamada devuelva FALSE.

Nota

El encabezado winnls.h define EnumSystemLocales 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

EnumLocalesProc

EnumSystemLocalesEx

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales