Función DownlevelLCIDToLocaleName

  • Artículo

Convierte un identificador de configuración regional en un nombre de configuración regional.

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 se ejecutan solo en Windows Vista y versiones posteriores deben llamar a LCIDToLocaleName para recuperar un nombre de configuración regional.

 

Sintaxis

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Parámetros

Locale [in]

Identificador de configuración regional que se va a traducir. Puede usar la macro MAKELCID para crear un identificador de configuración regional. Esta función no admite configuraciones regionales neutras ni los siguientes valores de identificador de configuración regional específicos.

lpName [out]

Puntero a un búfer en el que esta función recupera el nombre de la configuración regional. La función recupera NULL si cchName está establecido como 0.

cchName [in]

Tamaño, en puntos de código UTF-16, del búfer de nombres de configuración regional. La aplicación establece este parámetro como 0 para devolver el tamaño necesario del búfer de nombres de configuración regional.

dwFlags [in]

Marcas que especifican el tipo de nombre que se va a recuperar. El valor predeterminado es DOWNLEVEL_LOCALE_NAME.

Valor devuelto

Devuelve el recuento de puntos de código UTF-16 en el nombre de la configuración regional, incluido el carácter nulo de terminación, si se ejecuta correctamente. Si la función se ejecuta correctamente y el valor de cchName es 0, el valor devuelto es el tamaño necesario, en caracteres (incluidos caracteres nulos), para el búfer de nombre de configuración regional.

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_INSUFFICIENT_BUFFER. Un tamaño de búfer proporcionado no era lo suficientemente grande o se estableció incorrectamente en NULL.
  • ERROR_INVALID_FLAGS. El valor de dwFlags no es válido.
  • ERROR_INVALID_PARAMETER. Uno de los valores de parámetro no era válido.

Comentarios

Nota:

Esta función no admite configuraciones regionales personalizadas.

 

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

LCIDToLocaleName