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 antérieurs à Windows Vista. Son utilisation requiert 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
-
Paramètres régionaux [ dans]
-
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.
- paramètres régionaux _ INvariants
- paramètres régionaux _ _ par défaut du système
- paramètres régionaux _ par défaut de l’utilisateur _
Windows Vista et versions ultérieures : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.
-
lpName [ à]
-
Pointeur vers une mémoire tampon dans laquelle la fonction récupère le nom de paramètres régionaux parent, ou l’une des valeurs prédéfinies suivantes. Ce paramètre a la valeur null si cchName a la valeur 0.
-
cchName [ dans]
-
Taille de la mémoire tampon indiquée par lpName, en points de code UTF-16. La valeur 0 pour ce paramètre fait en sorte que la fonction ignore la mémoire tampon lpName et retourne la taille de la mémoire tampon, en caractères (caractères null inclus), requis 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 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 _ _ : paramètre non valide. Les valeurs de paramètre ne sont pas valides.
Remarques
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 Microsoft NLS onWindows XP avec SP2 et versions ultérieures |
| En-tête |
|
| DLL |
|