Fonction IsValidLocale (winnls.h)

  • Article

[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.

[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 Signification
LCID_INSTALLED
 Déterminez si l’identificateur de paramètres régionaux est à la fois pris en charge et installé.
LCID_SUPPORTED
 Déterminez si l’identificateur de paramètres régionaux est pris en charge.
0x39
 Ne pas utiliser. Utilisez plutôt LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP et Windows 2000 : La définition de dwFlags sur 0x39 est un cas particulier qui peut se comporter comme LCID_INSTALLED pour certains paramètres régionaux sur certaines versions de Windows.

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

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winnls.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GetLocaleInfo

IsValidLocaleName

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales