Función EnumSystemLocalesEx (winnls.h)

  • Artículo

Enumera las configuraciones regionales que se instalan o admiten en un sistema operativo.

Nota La aplicación debe llamar a esta función en preferencia a EnumSystemLocales si está diseñada para ejecutarse solo en Windows Vista y versiones posteriores.
 

Sintaxis

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

Parámetros

[in] lpLocaleEnumProcEx

Puntero a una función de devolución de llamada definida por la aplicación. La función EnumSystemLocalesEx enumera las configuraciones regionales mediante la realización de llamadas repetidas a esta función de devolución de llamada. Para obtener más información, vea EnumLocalesProcEx.

[in] dwFlags

Marcas que identifican las configuraciones regionales que se van a enumerar. Las marcas se pueden usar de forma sing o combinada mediante un OR binario. Si la aplicación especifica 0 para este parámetro, la función se comporta como para LOCALE_ALL.

[in] lParam

Parámetro proporcionado por la aplicación que se va a pasar a la función de devolución de llamada. Esto es especialmente útil para aplicaciones multiproceso.

[in, optional] lpReserved

Reservados; debe ser NULL.

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 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 las configuraciones regionales pasando nombres de configuración regional, de uno en uno, a la función de devolución de llamada definida por la aplicación especificada por lpLocaleEnumProcEx. La enumeración continúa hasta que se hayan pasado todos los nombres instalados o admitidos a la función de devolución de llamada o la función de devolución de llamada devuelve FALSE.

Las opciones para el parámetro dwFlags son diferentes de las de EnumSystemLocales, que deben distinguir entre las configuraciones regionales instaladas y admitidas.

Si dwFlags especifica LOCALE_ALTERNATE_SORTS, se llama a la función de devolución de llamada para cada configuración regional que representa un criterio de ordenación alternativo. Por ejemplo, español (España) tiene como valor predeterminado criterio de ordenación internacional, pero el criterio de ordenación tradicional está disponible para una ordenación alternativa. El valor predeterminado de Alemán (Alemania) es el criterio de ordenación del diccionario, pero hay disponible un criterio alternativo de ordenación de libreta de teléfonos.

Ejemplos

Puede encontrar un ejemplo en el que se muestra el uso de esta función en NLS: Ejemplo de API basadas en nombres.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumLocalesProcEx

EnumSystemLocales

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales