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.
Windows Vista et versions ultérieures : les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.
-
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.
-
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 |
|
| DLL |
|
Voir aussi