LOCALE_ENUMPROCEX callback function (winnls.h)

An application-defined callback function that processes enumerated locale information provided by the EnumSystemLocalesEx function. The LOCALE_ENUMPROCEX type defines a pointer to this callback function. EnumLocalesProcEx is a placeholder for the application-defined function name.

Syntax

LOCALE_ENUMPROCEX LocaleEnumprocex;

BOOL LocaleEnumprocex(
  LPWSTR unnamedParam1,
  DWORD unnamedParam2,
  LPARAM unnamedParam3
)
{...}

Parameters

unnamedParam1

Pointer to a buffer containing a null-terminated locale name string.

unnamedParam2

Flags defining locale information. Values for this parameter can include a binary OR of flags, but some flag combinations never occur. If the application specifiesLOCALE_WINDOWS or LOCALE_ALTERNATE_SORTS, it can also specify LOCALE_REPLACEMENT so that the EnumSystemLocalesEx function can test to see if the locale is a replacement.

• LOCALE_ALL
• LOCALE_ALTERNATE_SORTS; for more information, see EnumSystemLocalesEx
• LOCALE_NEUTRALDATA
• LOCALE_REPLACEMENT This constant is not a valid input to the dwFlags parameter of EnumSystemLocalesEx. To enumerate replacement locales, the application should call this function with the Arg2 parameter specified as LOCALE_WINDOWS or LOCALE_ALL, then check for this constant in the callback function.
• LOCALE_SUPPLEMENTAL
• LOCALE_WINDOWS
• LOCALE_NEUTRALDATA
• LOCALE_SPECIFICDATA

unnamedParam3

An application-provided input parameter of EnumSystemLocalesEx. This value is especially useful for multi-threaded applications, since it can be used to pass thread-specific data to this callback function.

Return value

Returns TRUE to continue enumeration or FALSE otherwise.

Remarks

An EnumLocalesProcEx function can carry out any desired task. The application registers this function by passing its address to the EnumSystemLocalesEx function.

Requirements

See also

EnumSystemLocalesEx

National Language Support

National Language Support Functions