DownlevelLCIDToLocaleName fonction)

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

Notes

cette fonction est utilisée uniquement par les applications qui s’exécutent sur des systèmes d’exploitation antérieurs à Windows Vista. Son utilisation requiert 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 [ dans]

Identificateur de paramètres régionaux à convertir. 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 [ à]

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 la valeur null si cchName a la valeur 0.

cchName [ dans]

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

dwFlags [ dans]

Indicateurs spécifiant le type de nom à récupérer. La valeur par défaut est le nom des paramètres régionaux de niveau inférieur _ _ .

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 est réussie 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 fonctionne pas. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

  • ERREUR _ de _ mémoire tampon insuffisante. La taille de la mémoire tampon fournie n’est pas assez grande ou n’a pas été correctement définie sur null.
  • ERREUR _ : indicateurs non valides _ . La valeur de dwFlags n’est pas valide.
  • ERREUR _ _ : paramètre non valide. Les valeurs de paramètre ne sont pas valides.

Remarques

Notes

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 des API de mappage de données Microsoft NLS, disponible dans le Centre de téléchargement Microsoft.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
Composant redistribuable
API de mappage de données de niveau inférieur Microsoft NLS onWindows XP avec SP2 et laterorWindows Vista
En-tête
Nlsdl. h
DLL
NlsMap.dll

Voir aussi

Prise en charge des langues nationales

Fonctions de prise en charge linguistique nationale

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

LCIDToLocaleName