Fonction CharUpperBuffA (winuser.h)
Convertit les caractères minuscules dans une mémoire tampon en caractères majuscules. La fonction convertit les caractères en place.
Syntaxe
DWORD CharUpperBuffA(
[in, out] LPSTR lpsz,
[in] DWORD cchLength
);
Paramètres
[in, out] lpsz
Type : LPTSTR
Mémoire tampon contenant un ou plusieurs caractères à traiter.
[in] cchLength
Type : DWORD
Taille, en caractères, de la mémoire tampon pointée par lpsz.
La fonction examine chaque caractère et convertit les caractères minuscules en caractères majuscules. La fonction examine le nombre de caractères indiqués par cchLength, même si un ou plusieurs caractères sont des caractères Null.
Valeur de retour
Type : DWORD
La valeur de retour est le nombre de caractères traités.
Par exemple, si CharUpperBuff(« Zenith of API Sets », 10) réussit, la valeur de retour est 10.
Remarques
Notez que CharUpperBuff mappe toujours les minuscules I (« i ») en majuscules I, même lorsque la langue actuelle est turque ou azerbaïdjan. Si vous avez besoin d’une fonction sensible linguistiquement à cet égard, appelez LCMapString.
La conversion en Unicode dans la version ANSI de la fonction est effectuée avec les paramètres régionaux système par défaut dans tous les cas.
Exemples
Pour obtenir un exemple, consultez Création et utilisation d’un fichier temporaire.
Note
L’en-tête winuser.h définit CharUpperBuff comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
conceptuelle
de référence