Función DownlevelGetParentLocaleName

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

Configuración regional [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 la configuración regional primaria 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 omita 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 primario.

Valor devuelto

Devuelve el recuento de puntos de código UTF-16 en el nombre de 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 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.
  • ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Observaciones

El archivo de encabezado y dll necesarios forman parte de la descarga "Microsoft NLS Downlevel Data Mapping APIs", disponible en el Centro de descarga de Microsoft.

Requisitos

Requisito Value
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 enWindows 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

Asignar datos de configuración regional

GetLocaleInfo