DownlevelGetParentLocaleLCID function

Retrieves the locale identifier for the parent of the supplied locale.

Note

This function is used only by applications that run on pre-Windows Vista operating systems. Its use requires the download package. Applications that only run on Windows Vista and later should call GetLocaleInfo with LCType set to LOCALE_SPARENT.

 

Syntax

LCID DownlevelGetParentLocaleLCID(
  _In_ LCID Locale
);

Parameters

Locale [in]

Locale identifier of the locale for which to retrieve the parent locale identifier. You can use the MAKELCID macro to create a locale identifier or use one of the following predefined values.

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

Return value

Returns the parent locale identifier if successful, or 0 otherwise. To get extended error information, the application can call GetLastError, which can return one of the following error codes:

  • ERROR_INVALID_PARAMETER. Any of the parameter values was invalid.

Remarks

The required header file and DLL are part of the "Microsoft NLS Downlevel Data Mapping APIs" download, which is no longer available from the Microsoft Download Center. Use ICU globalization APIs on Windows 10 May 2019 Update and later versions.

Requirements

Requirement Value
Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Redistributable
Microsoft NLS Downlevel Data Mapping APIs onWindows XPor Windows Vista
Header
Nlsdl.h
DLL
NlsMap.dll

See also

National Language Support

National Language Support Functions

Mapping Locale Data

GetLocaleInfo