Función DownlevelLocaleNameToLCID

Convierte un nombre de configuración regional de un identificador de configuración regional que se puede usar para obtener información del sistema operativo.

Nota:

Esta función solo la usan las aplicaciones que se ejecutan en sistemas operativos anteriores a Windows Vista. Su uso requiere un paquete de descarga. Las aplicaciones que solo se ejecutan en Windows Vista y versiones posteriores deben llamar a LocaleNameToLCID para recuperar un identificador de configuración regional.

 

Sintaxis

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Parámetros

lpName [in]

Puntero a una cadena terminada en null que representa un nombre de configuración regional.

dwFlags [in]

Marcas que especifican el tipo de nombre. El valor predeterminado es DOWNLEVEL_LOCALE_NAME.

Valor devuelto

Devuelve el identificador de configuración regional que corresponde al nombre de configuración regional si se ejecuta correctamente.

Esta función devuelve 0 si no se realiza correctamente. Para obtener más información de error, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

• ERROR_INVALID_FLAGS. Los valores proporcionados para las marcas no eran válidos.
• ERROR_INVALID_PARAMETER. Uno de los valores de parámetro no era válido.

Comentarios

Nota:

Esta función no admite configuraciones regionales neutras. La función LocaleNameToLCIDequivalente admite configuraciones regionales personalizadas, pero solo para Windows Vista y versiones posteriores.

 

El archivo de encabezado y DLL necesarios forman parte de la descarga "API de asignación de datos de nivel inferior de Microsoft NLS", que ya no está disponible en el Centro de descarga de Microsoft. Use las API de globalización de ICU en la actualización de mayo de 2019 de Windows 10 y versiones posteriores.

Requisitos

Requisito	Valor
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Redistribuible	API de asignación de datos de nivel inferior de Microsoft NLS en Windows XP con SP2 y versiones posteriores o Windows Vista
Encabezado	Nlsdl.h
Archivo DLL	NlsMap.dll

Consulte también

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

Asignación de datos de configuración regional

LocaleNameToLCID