UID

title

description

helpviewer_keywords

old-location

tech.root

ms.assetid

ms.date

ms.keywords

req.header

req.include-header

req.target-type

req.target-min-winverclnt

req.target-min-winversvr

req.kmdf-ver

req.umdf-ver

req.ddi-compliance

req.unicode-ansi

req.idl

req.max-support

req.namespace

req.assembly

req.type-library

req.lib

req.dll

req.irql

targetos

req.typenames

req.redist

ms.custom

f1_keywords

dev_langs

topic_type

api_type

api_location

api_name

NF:winnls.ConvertDefaultLocale

ConvertDefaultLocale function (winnls.h)

Converts a default locale value to an actual locale identifier.

ConvertDefaultLocale

ConvertDefaultLocale function [Internationalization for Windows Applications]

_win32_ConvertDefaultLocale

intl.convertdefaultlocale

winnls/ConvertDefaultLocale

intl\convertdefaultlocale.htm

Intl

e227bb9f-f072-4e44-bd55-24c98b990a36

12/05/2018

ConvertDefaultLocale, ConvertDefaultLocale function [Internationalization for Windows Applications], _win32_ConvertDefaultLocale, intl.convertdefaultlocale, winnls/ConvertDefaultLocale

winnls.h

Windows.h

Windows

Windows 2000 Professional [desktop apps only]

Windows 2000 Server [desktop apps only]

Kernel32.lib

Kernel32.dll

Windows

19H1

ConvertDefaultLocale

winnls/ConvertDefaultLocale

c++

APIRef

kbSyntax

DllExport

kernel32.dll

API-MS-Win-Core-Localization-l1-1-0.dll

KernelBase.dll

API-MS-Win-Core-Localization-l1-2-0.dll

API-MS-Win-Core-Localization-l1-2-1.dll

API-MS-Win-DownLevel-Kernel32-l1-1-0.dll

MinKernelBase.dll

API-MS-Win-Core-Localization-L1-2-2.dll

ConvertDefaultLocale

ConvertDefaultLocale function

-description

Converts a default locale value to an actual locale identifier.

Note This function is only provided for converting partial locale identifiers. Your applications should use locale names instead of identifiers. The LCIDToLocaleName function can be used to convert a locale identifier to a valid locale name. Your application can also use GetUserDefaultLocaleName to retrieve the current user locale name; GetSystemDefaultLocaleName to retrieve the current system locale name; and GetLocaleInfoEx with LOCALE_SNAME to retrieve the locale name for any input locale, including the default constants.

-parameters

-param Locale [in]

Default locale identifier value to convert. You can use the MAKELCID macro to create a locale identifier or use one of the following predefined values.

LOCALE_INVARIANT
LOCALE_SYSTEM_DEFAULT
LOCALE_USER_DEFAULT

Windows Vista and later: The following custom locale identifiers are also supported.

LOCALE_CUSTOM_DEFAULT
LOCALE_CUSTOM_UI_DEFAULT
LOCALE_CUSTOM_UNSPECIFIED

-returns

Returns the appropriate locale identifier if successful.

This function returns the value of the Locale parameter if it does not succeed. The function fails when the Locale value is not one of the default values listed above.

-remarks

A call to ConvertDefaultLocale specifying LOCALE_SYSTEM_DEFAULT is equivalent to a call to GetSystemDefaultLCID. A call to ConvertDefaultLocale specifying LOCALE_USER_DEFAULT is equivalent to a call to GetUserDefaultLCID.