DownlevelGetParentLocaleName, fonction

Récupère le nom des paramètres régionaux pour le parent des paramètres régionaux fournis.

Remarque

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 nécessite le package de téléchargement. Les applications qui s’exécutent uniquement sur Windows Vista et versions ultérieures doivent appeler GetLocaleInfo avec LCType défini sur LOCALE_SPARENT.

 

Syntaxe

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Paramètres

Locale [in]

Identificateur de paramètres régionaux des paramètres régionaux. 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_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista et versions ultérieures : les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

Pointeur vers une mémoire tampon dans laquelle la fonction récupère le nom des paramètres régionaux parents ou l’une des valeurs prédéfinies suivantes. Ce paramètre est défini sur NULL si cchName est défini sur 0.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

cchName [in]

Taille de la mémoire tampon indiquée par lpName, en points de code UTF-16. Une valeur de 0 pour ce paramètre force la fonction à ignorer la mémoire tampon lpName et à retourner la taille de la mémoire tampon, en caractères (caractères nuls inclus), nécessaire pour contenir le nom des paramètres régionaux parents.

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.

Cette 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 était incorrectement définie sur NULL.
• ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Notes

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 dans le 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 SP2 et versions ultérieures
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

GetLocaleInfo