Partager via


CharToOemA, fonction (winuser.h)

Convertit une chaîne en jeu de caractères défini par OEM.

Warning Do not use. Consultez considérations relatives à la sécurité.
 

Syntax

BOOL CharToOemA(
  [in]  LPCSTR pSrc,
  [out] LPSTR  pDst
);

Parameters

[in] pSrc

Type: LPCTSTR

Chaîne terminée par null à traduire.

[out] pDst

Type: LPSTR

Mémoire tampon de destination, qui reçoit la chaîne traduite. If the CharToOem function is being used as an ANSI function, the string can be translated in place by setting the lpszDst parameter to the same address as the lpszSrc parameter. This cannot be done if CharToOem is being used as a wide-character function.

Return value

Type: BOOL

The return value is always nonzero except when you pass the same address to lpszSrc and lpszDst in the wide-character version of the function. In this case the function returns zero and GetLastError returns ERROR_INVALID_ADDRESS.

Remarks

Security Considerations

L’utilisation incorrecte de cette fonction peut compromettre la sécurité de votre programme. For example, miscalculating the proper size of the lpszDst buffer, especially when the application is used in both ANSI and Unicode versions, can cause a buffer overflow. Pour plus d’informations, consultez Considérations relatives à la sécurité : Fonctionnalités internationales et considérations de sécurité : Interface utilisateur Windows.

Note

L’en-tête winuser.h définit CharToOem 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.

Requirements

Requirement Value
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-chartranslation-l1-1-0 (introduit dans Windows 8)

See also

CharToOemBuff

Conceptual

OemToChar

OemToCharBuff

Reference

Strings