Fonction DownlevelLocaleNameToLCID

Permet de convertir un nom de paramètres régionaux en identificateur de paramètres régionaux qui peut servir à obtenir des informations à partir du système d’exploitation.

Remarque

Cette fonction est utilisée uniquement par des applications qui s’exécutent sur des systèmes d’exploitation antérieurs à Windows Vista. Son utilisation nécessite un package de téléchargement. Les applications qui s’exécutent uniquement sous Windows Vista et les versions ultérieures doivent appeler LocaleNameToLCID pour récupérer un identificateur de paramètres régionaux.

 

Syntaxe

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Paramètres

lpName [entrée]

Pointeur vers une chaîne terminée par une valeur nulle représentant un nom de paramètres régionaux.

dwFlags [in]

Indicateurs spécifiant le type de nom. La valeur par défaut est DOWNLEVEL_LOCALE_NAME.

Valeur retournée

Retourne l’identificateur de paramètres régionaux qui correspond au nom des paramètres régionaux en cas de réussite.

La fonction retourne 0 si elle ne réussit pas. Pour obtenir des informations sur l’erreur étendue, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

  • ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
  • ERROR_INVALID_PARAMETER. Toutes les valeurs de paramètre n’étaient pas valides.

Notes

Remarque

Cette fonction ne prend pas en charge les paramètres régionaux neutres. La fonction LocaleNameToLCID équivalente prend en charge les paramètres régionaux personnalisés, mais uniquement pour Windows Vista et versions ultérieures.

 

Le fichier d’en-tête et la DLL requis font partie du téléchargement « API de mappage de données de bas niveau Microsoft NLS », qui n’est plus disponible à partir du Centre de téléchargement Microsoft. Utilisez les API de globalisation ICU sur la mise à jour de mai 2019 de Windows 10 et versions ultérieures.

Spécifications

Condition requise Value
Client minimal pris en charge
Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
Composant redistribuable
API de mappage de données de bas niveau Microsoft NLS sur Windows XP avec SP2 et versions ultérieures ou Windows Vista
En-tête
Nlsdl.h
DLL
NlsMap.dll

Voir aussi

National Language Support

Fonctions National Language Support

Mappage des données de paramètres régionaux

LocaleNameToLCID