Función EnumSystemLocalesEx (winnls.h)
Enumera las configuraciones regionales que se instalan en o son compatibles con un sistema operativo.
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 realizando 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 singly o combinadas mediante un OR binario. Si la aplicación especifica 0 para este parámetro, la función se comporta como para LOCALE_ALL.
- LOCALE_ALL
- LOCALE_ALTERNATE_SORTS; ver comentarios
- LOCALE_NEUTRALDATA
- LOCALE_SUPPLEMENTAL
- LOCALE_WINDOWS
- LOCALE_SPECIFICDATA
[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 las aplicaciones multiproceso.
[in, optional] lpReserved
Reservado; 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 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 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 del 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 el criterio de ordenación internacional, pero el criterio de ordenación tradicional está disponible para una ordenación alternativa. Alemán (Alemania) tiene como valor predeterminado el criterio de ordenación del diccionario, pero hay un criterio de ordenación de libreta de teléfonos alternativo disponible.
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 | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows Server 2008 [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 |