DownlevelGetParentLocaleName function

  • Artículo

Recupera el nombre de la configuración regional del elemento primario de la configuración regional proporcionada.

Nota:

Esta función solo la usan las aplicaciones que se ejecutan en sistemas operativos anteriores a Windows Vista. Su uso requiere el paquete de descarga. Las aplicaciones que solo se ejecutan en Windows Vista y versiones posteriores deben llamar a GetLocaleInfo con LCType establecido en LOCALE_SPARENT.

 

Sintaxis

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Parámetros

Locale [in]

Identificador de configuración regional de la configuración regional. Puede usar la macro MAKELCID para crear un identificador de configuración regional o usar uno de los siguientes valores predefinidos.

Windows Vista y versiones posteriores: también se admiten los siguientes identificadores de configuración regional personalizados.

lpName [out]

Puntero a un búfer en el que la función recupera el nombre de configuración regional principal o uno de los siguientes valores predefinidos. Este parámetro se establece en NULL si cchName está establecido en 0.

cchName [in]

Tamaño del búfer indicado por lpName, en puntos de código UTF-16. Un valor de 0 para este parámetro hace que la función ignore el búfer lpName y devuelva el tamaño del búfer, en caracteres (caracteres NULL incluidos), necesario para contener el nombre de configuración regional principal.

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.

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_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Comentarios

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
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

GetLocaleInfo