Expand Minimize

DownlevelLCIDToLocaleName function

Converts a locale identifier to a locale name.

Note   This function is used only by applications that run on pre-Windows Vista operating systems. Its use requires a download package. Applications that run only on Windows Vista and later should call LCIDToLocaleName to retrieve a locale name.

Syntax


int DownlevelLCIDToLocaleName(
  _In_   LCID Locale,
  _Out_  LPWSTR lpName,
  _In_   int cchName,
  _In_   DWORD dwFlags
);

Parameters

Locale [in]

The locale identifier to translate. You can use the MAKELCID macro to create a locale identifier. This function does not support neutral locales or the following specific locale identifier values.

lpName [out]

Pointer to a buffer in which this function retrieves the locale name. The function retrieves NULL if cchName is set to 0.

cchName [in]

Size, in UTF-16 code points, of the locale name buffer. The application sets this parameter to 0 to return the required size of the locale name buffer.

dwFlags [in]

Flags specifying the type of name to retrieve. The default value is DOWNLEVEL_LOCALE_NAME.

Return value

Returns the count of UTF-16 code points in the locale name, including the terminating null character, if successful. If the function succeeds and the value of cchName is 0, the return value is the required size, in characters (including null characters), for the locale name buffer.

The function returns 0 if it does not succeed. To get extended error information, the application can call GetLastError, which can return one of the following error codes:

  • ERROR_INSUFFICIENT_BUFFER. A supplied buffer size was not large enough, or it was incorrectly set to NULL.
  • ERROR_INVALID_FLAGS. The value of dwFlags is not valid.
  • ERROR_INVALID_PARAMETER. Any of the parameter values were invalid.

Remarks

Note   This function does not support custom locales.

The required header file and DLL are part of the "Microsoft NLS Downlevel Data Mapping APIs" download, available at the Microsoft Download Center.

Requirements

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 XP with SP2 and laterorWindows Vista

Header

Nlsdl.h

DLL

NlsMap.dll

See also

National Language Support
National Language Support Functions
Mapping Locale Data
LCIDToLocaleName

 

 

Community Additions

ADD
Show:
© 2014 Microsoft