This topic has not yet been rated - Rate this topic

EnumLanguageGroupLocales function

Applies to: desktop apps only

Enumerates the locales in a specified language group.

Note  For custom locales, your application should call EnumSystemLocalesEx in preference to EnumLanguageGroupLocales.

Syntax

BOOL EnumLanguageGroupLocales(
  __in  LANGGROUPLOCALE_ENUMPROC lpLangGroupLocaleEnumProc,
  __in  LGRPID LanguageGroup,
  __in  DWORD dwFlags,
  __in  LONG_PTR lParam
);

Parameters

lpLangGroupLocaleEnumProc [in]

Pointer to an application-defined callback function. For more information, see EnumLanguageGroupLocalesProc.

LanguageGroup [in]

Identifier of the language group for which to enumerate locales. This parameter can have one of the following values:

  • LGRPID_ARABIC
  • LGRPID_ARMENIAN
  • LGRPID_BALTIC
  • LGRPID_CENTRAL_EUROPE
  • LGRPID_CYRILLIC
  • LGRPID_GEORGIAN
  • LGRPID_GREEK
  • LGRPID_HEBREW
  • LGRPID_INDIC
  • LGRPID_JAPANESE
  • LGRPID_KOREAN
  • LGRPID_SIMPLIFIED_CHINESE
  • LGRPID_TRADITIONAL_CHINESE
  • LGRPID_THAI
  • LGRPID_TURKIC
  • LGRPID_TURKISH
  • LGRPID_VIETNAMESE
  • LGRPID_WESTERN_EUROPE
dwFlags [in]

Reserved; must be 0.

lParam [in]

An application-defined value to pass to the callback function. This value can be used for error checking. It can also be used to ensure thread safety in the callback function.

Return value

Returns a nonzero value 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_BADDB. The function could not access the data. This situation should not normally occur, and typically indicates a bad installation, a disk problem, or the like.
  • ERROR_INVALID_FLAGS. The values supplied for flags were not valid.
  • ERROR_INVALID_PARAMETER. Any of the parameter values was invalid.

Remarks

This function enumerates locales in the specified language group by passing locale identifiers, one at a time, to the application-defined callback function. This process continues until EnumLanguageGroupLocales finds the last locale identifier or the callback function returns FALSE.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Winnls.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

Unicode and ANSI names

EnumLanguageGroupLocalesW (Unicode) and EnumLanguageGroupLocalesA (ANSI)

See also

National Language Support
National Language Support Functions
EnumLanguageGroupLocalesProc
EnumSystemLanguageGroups
EnumSystemLocalesEx
IsValidLanguageGroup

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ