DownlevelGetParentLocaleName function
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 |
|
| Archivo DLL |
|
Consulte también