Función DownlevelLCIDToLocaleName
Convierte un identificador de configuración regional en un nombre de configuración regional.
Nota:
Esta función solo la usan las aplicaciones que se ejecutan en sistemas operativos anteriores a Windows Vista. Su uso requiere un paquete de descarga. Las aplicaciones que se ejecutan solo en Windows Vista y versiones posteriores deben llamar a LCIDToLocaleName para recuperar un nombre de configuración regional.
Sintaxis
int DownlevelLCIDToLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName,
_In_ DWORD dwFlags
);
Parámetros
-
Locale [in]
-
Identificador de configuración regional que se va a traducir. Puede usar la macro MAKELCID para crear un identificador de configuración regional. Esta función no admite configuraciones regionales neutras ni los siguientes valores de identificador de configuración regional específicos.
-
lpName [out]
-
Puntero a un búfer en el que esta función recupera el nombre de la configuración regional. La función recupera NULL si cchName está establecido como 0.
-
cchName [in]
-
Tamaño, en puntos de código UTF-16, del búfer de nombres de configuración regional. La aplicación establece este parámetro como 0 para devolver el tamaño necesario del búfer de nombres de configuración regional.
-
dwFlags [in]
-
Marcas que especifican el tipo de nombre que se va a recuperar. El valor predeterminado es DOWNLEVEL_LOCALE_NAME.
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. Si la función se ejecuta correctamente y el valor de cchName es 0, el valor devuelto es el tamaño necesario, en caracteres (incluidos caracteres nulos), para el búfer de nombre de configuración regional.
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_FLAGS. El valor de dwFlags no es válido.
- ERROR_INVALID_PARAMETER. Uno de los valores de parámetro no era válido.
Comentarios
Nota:
Esta función no admite configuraciones regionales personalizadas.
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 o Windows Vista |
| Encabezado |
|
| Archivo DLL |
|
Consulte también