Función ConvertDefaultLocale (winnls.h)

Artículo
08/27/2023

Convierte un valor de configuración regional predeterminado en un identificador de configuración regional real.

Nota Esta función solo se proporciona para convertir identificadores de configuración regional parciales. Las aplicaciones deben usar nombres de configuración regional en lugar de identificadores. La función LCIDToLocaleName se puede usar para convertir un identificador de configuración regional en un nombre de configuración regional válido. La aplicación también puede usar GetUserDefaultLocaleName para recuperar el nombre de configuración regional del usuario actual; GetSystemDefaultLocaleName para recuperar el nombre de configuración regional del sistema actual; y GetLocaleInfoEx con LOCALE_SNAME para recuperar el nombre de la configuración regional de cualquier configuración regional de entrada, incluidas las constantes predeterminadas.

Sintaxis

LCID ConvertDefaultLocale(
  [in] LCID Locale
);

Parámetros

[in] Locale

Valor predeterminado del identificador de configuración regional que se va a convertir. 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.

Valor devuelto

Devuelve el identificador de configuración regional adecuado si se ejecuta correctamente.

Esta función devuelve el valor del parámetro Configuración regional si no se realiza correctamente. Se produce un error en la función cuando el valor de configuración regional no es uno de los valores predeterminados enumerados anteriormente.

Comentarios

Una llamada a ConvertDefaultLocale que especifica LOCALE_SYSTEM_DEFAULT es equivalente a una llamada a GetSystemDefaultLCID. Una llamada a ConvertDefaultLocale que especifica LOCALE_USER_DEFAULT equivale a una llamada a GetUserDefaultLCID.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winnls.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll