CharToOemBuffA, fonction (winuser.h)
Traduit un nombre spécifié de caractères dans une chaîne dans le jeu de caractères défini par l’OEM.
Syntaxe
BOOL CharToOemBuffA(
[in] LPCSTR lpszSrc,
[out] LPSTR lpszDst,
[in] DWORD cchDstLength
);
Paramètres
[in] lpszSrc
Type : LPCTSTR
Chaîne terminée par null à traduire.
[out] lpszDst
Type : LPSTR
Mémoire tampon de la chaîne traduite. Si la fonction CharToOemBuff est utilisée comme fonction ANSI, la chaîne peut être traduite en place en définissant le paramètre lpszDst sur la même adresse que le paramètre lpszSrc. Cela ne peut pas être effectué si CharToOemBuff est utilisé comme fonction à caractères larges.
[in] cchDstLength
Type : DWORD
Nombre de caractères à traduire dans la chaîne identifiée par le paramètre lpszSrc.
Valeur de retour
Type : BOOL
La valeur de retour est toujours différente de zéro, sauf lorsque vous passez la même adresse à lpszSrc et lpszDst dans la version large de la fonction. Dans ce cas, la fonction retourne zéro et GetLastError retourne ERROR_INVALID_ADDRESS.
Remarques
Contrairement à la fonction CharToOem, la fonction CharToOemBuff n’arrête pas de convertir des caractères lorsqu’elle rencontre un caractère Null dans la mémoire tampon pointée par lpszSrc. La fonction CharToOemBuff convertit tous les caractères cchDstLength.
Note
L’en-tête winuser.h définit CharToOemBuff 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 |
| ensemble d’API | ext-ms-win-ntuser-chartranslation-l1-1-0 (introduit dans Windows 8) |
Voir aussi
conceptuelle
de référence