Fonction DownlevelLCIDToLocaleName

Article
12/22/2023

Convertit un identificateur de paramètres régionaux en nom de paramètres régionaux.

Remarque

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

Syntaxe

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Paramètres

Paramètres régionaux [in]

L’identificateur de paramètres régionaux à traduire. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur de paramètres régionaux. Cette fonction ne prend pas en charge les paramètres régionaux neutres ou les valeurs d’identificateur de paramètres régionaux spécifiques suivantes.

lpName [out]

Pointeur vers une mémoire tampon dans laquelle cette fonction récupère le nom des paramètres régionaux. La fonction récupère NULL si cchName a la valeur 0.

cchName[in]

Taille, en points de code UTF-16, de la mémoire tampon du nom des paramètres régionaux. L’application définit ce paramètre sur 0 pour retourner la taille requise de la mémoire tampon du nom des paramètres régionaux.

dwFlags [in]

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

Valeur retournée

Retourne le nombre de points de code UTF-16 dans le nom des paramètres régionaux, y compris le caractère Null de fin, en cas de réussite. Si la fonction réussit et que la valeur de cchName est 0, la valeur de retour est la taille requise, en caractères (y compris les caractères Null), pour la mémoire tampon du nom des paramètres régionaux.

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

ERROR_INSUFFICIENT_BUFFER. Une taille de mémoire tampon fournie n’était pas suffisamment grande, ou elle était incorrectement définie sur NULL.
ERROR_INVALID_FLAGS. La valeur de dwFlags n’est pas valide.
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 personnalisés.

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
LCIDToLocaleName