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 Windows Vista. Su uso requiere el paquete de descarga. Las aplicaciones que solo se ejecutan 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 [ En]

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 [ En]

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 la configuración regional primaria.

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 realiza 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 _ BÚFER _ INSUFICIENTE. Un tamaño de búfer proporcionado no era lo suficientemente grande o se estableció incorrectamente en NULL.
  • ERROR _ PARÁMETRO _ NO VÁLIDO. Cualquiera de los valores de parámetro no era válido.

Comentarios

El archivo de encabezado y el archivo DLL necesarios forman parte de la descarga "API de asignación de datos de nivel inferior de Microsoft NLS", disponible en el Centro de descarga de Microsoft.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Solo [ aplicaciones de escritorio XP]
Servidor mínimo compatible
Windows Solo aplicaciones de escritorio de Server 2003 []
Redistribuible
API de asignación de datos de nivel inferior de Microsoft NLS enWindows XP con SP2 y versiones posteriores
Header
Nlsdl.h
Archivo DLL
NlsMap.dll

Vea también

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales

Asignación de datos de configuración regional

GetLocaleInfo