DownlevelGetParentLocaleName, fonction

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

Notes

Cette fonction est utilisée uniquement par les applications qui s’exécutent sur des systèmes d’exploitation Vista pré-Windows. Son utilisation nécessite le package de téléchargement. Les applications qui s’exécutent uniquement sur Windows Vista et les 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

Paramètres régionaux [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 parent 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, dans les points de code UTF-16. Une valeur de 0 pour ce paramètre entraîne l’ignorer de la mémoire tampon lpName et retourne la taille de la mémoire tampon, en caractères (caractères null inclus), requise pour contenir le nom des paramètres régionaux parent.

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 s’il 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_PARAMETER. Toutes les valeurs de paramètre n’ont pas été valides.

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 », disponible dans le Centre de téléchargement Microsoft.

Configuration requise

Condition requise Valeur
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 des données de niveau inférieur Microsoft NLS surWindows XP avec SP2 et versions ultérieures
En-tête
Nlsdl.h
DLL
NlsMap.dll

Voir aussi

Prise en charge nationale de la langue

Fonctions de prise en charge des langues nationales

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

GetLocaleInfo