Fonction IsValidLocale (winnls.h)

[IsValidLocale est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Au lieu de cela, utilisez IsValidLocaleName pour déterminer la validité d’un paramètre régional supplémentaire.]

Détermine si les paramètres régionaux spécifiés sont installés ou pris en charge sur le système d’exploitation. Pour plus d’informations, consultez Paramètres régionaux et langues.

Syntaxe

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Paramètres

[in] Locale

Identificateur des paramètres régionaux à valider. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur de paramètres régionaux ou utiliser l’une des valeurs prédéfinies suivantes.

• LOCALE_CUSTOM_DEFAULTWindows Server 2003, Windows XP et Windows 2000 : cet identificateur de paramètres régionaux n’est pas pris en charge.
• LOCALE_CUSTOM_UI_DEFAULTWindows Server 2003, Windows XP et Windows 2000 : cet identificateur de paramètres régionaux n’est pas pris en charge.
• LOCALE_CUSTOM_UNSPECIFIEDWindows Server 2003, Windows XP et Windows 2000 : cet identificateur de paramètres régionaux n’est pas pris en charge.
• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

[in] dwFlags

Indicateur spécifiant le test de validité à appliquer à l’identificateur de paramètres régionaux. Ce paramètre peut avoir l’une des valeurs suivantes.

Valeur retournée

Retourne une valeur différente de zéro si l’identificateur de paramètres régionaux réussit le test de validité spécifié. La fonction retourne 0 si elle ne réussit pas.

Remarques

Si l’indicateur LCID_INSTALLED est spécifié et que cette fonction retourne une valeur différente de zéro, l’identificateur de paramètres régionaux est à la fois pris en charge et installé sur le système d’exploitation. L’installation d’un identificateur implique que le niveau complet de prise en charge linguistique est disponible pour les paramètres régionaux indiqués. La prise en charge complète inclut les tables de traduction de pages de code, les dispositions du clavier, les polices, ainsi que les données de tri et de paramètres régionaux.

Si LCID_SUPPORTED est spécifié et que cette fonction retourne 0, l’identificateur de paramètres régionaux est pris en charge dans la version, mais pas nécessairement installé sur le système d’exploitation.

Cette fonction peut gérer des données à partir de paramètres régionaux personnalisés. Il n’est pas garanti que les données soient identiques d’un ordinateur à l’autre ou entre les exécutions d’une application. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

Configuration requise

Voir aussi

GetLocaleInfo

IsValidLocaleName

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales