IsValidLocale

The IsValidLocale function applies a validity test to a locale identifier. The dwFlags parameter determines the nature of the validity test. Currently, the function tests whether a locale identifier is installed or supported on the calling system.

BOOL IsValidLocale(
  LCID Locale,    // locale identifier to validate
  DWORD dwFlags   // specifies validity test
);
 

Parameters

Locale
Specifies the locale identifier to be validated. You can use the MAKELCID macro to create a locale identifier.
dwFlags
Specifies the validity test to apply to the locale identifier. This parameter can be one of the following values:
Value Meaning
LCID_INSTALLED Test whether the locale identifier is both supported and installed.
LCID_SUPPORTED Test whether the locale identifier is supported.

Return Values

If the locale identifier passes the specified validity test, the return value is nonzero.

If the locale identifier does not pass the specified validity test, the return value is zero.

Remarks

If the LCID_INSTALLED flag is specified and this function returns a nonzero value, the locale identifier is both supported and installed on the system.

If the LCID_SUPPORTED flag is specified and this function returns zero, the locale identifier is supported in the release, but not necessarily installed on the system.

For more information, see Locales.

QuickInfo

  Windows NT: Requires version 3.5 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in winnls.h.
  Import Library: Use kernel32.lib.

See Also

National Language Support Overview, National Language Support Functions, GetLocaleInfo