Función ResolveLocaleName (winnls.h)

  • Artículo

Busca una coincidencia de nombre de configuración regional posible para el nombre proporcionado.

Sintaxis

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

Parámetros

[in, optional] lpNameToResolve

Puntero a un nombre para resolver, por ejemplo, "en-XA" para inglés (uso privado).

[out, optional] lpLocaleName

Puntero a un búfer en el que esta función recupera el nombre de la configuración regional que es la coincidencia para el nombre de entrada. Por ejemplo, la coincidencia del nombre "en-XA" es "en-US" para inglés (Estados Unidos).

Nota Si se produce un error en la función, no se garantiza que el estado del búfer de salida sea preciso. En este caso, la aplicación debe comprobar el valor devuelto y el estado de error establecido por la función para determinar el curso de acción correcto.
 

[in] cchLocaleName

Tamaño, en caracteres, del búfer indicado por lpLocaleName. La longitud máxima posible de un nombre de configuración regional, incluido un carácter nulo de terminación, es el valor de LOCALE_NAME_MAX_LENGTH. Este es el tamaño recomendado que se debe proporcionar en este parámetro.

Valor devuelto

Devuelve el tamaño del búfer que contiene el nombre de la configuración regional, incluido el carácter nulo de terminación, si se ejecuta correctamente.

La función devuelve 0 si no se realiza correctamente. 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_INSUFFICIENT_BUFFER. Un tamaño de búfer proporcionado no era lo suficientemente grande o se estableció incorrectamente en NULL.

Comentarios

El nombre de configuración regional recuperado indica una configuración regional específica, incluido el idioma y el país o región, incluso si el idioma de entrada es neutro. Por ejemplo, una entrada de "en" para inglés (Estados Unidos) hace que la función recupere "en-US".

Esta función puede recuperar datos de configuraciones regionales personalizadas. No se garantiza que los datos sean los mismos desde el equipo al equipo o entre ejecuciones de una aplicación, ni la devolución de una configuración regional válida garantiza que será válido en otro equipo. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

A partir de Windows 8:ResolveLocaleName debe convertir las etiquetas de idioma obtenidas del espacio de nombres Windows.Globalization para poder usarlas con cualquier función de compatibilidad con lenguaje nacional.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

Windows.Globalization